Does this skill overwrite my existing documentation?

No, the skill always checks for existing files and will prompt you to choose whether to keep, edit, or replace the file if it already exists.

How does the skill determine the repository guidelines?

The skill performs a brief scan of your top-level structure and reads core files like README, CONTRIBUTING, and configuration files (e.g., package.json) to extract relevant patterns.

Can I initialize a guide for a specific subdirectory?

Yes, you can use the command '/init ' to create a scoped guide for a specific folder, which is particularly useful for monorepos.

What is an AGENTS.md file?

An AGENTS.md file is a specialized contributor guide designed to give AI agents specific context about a project's structure, tools, and coding standards to improve their performance.

Agent Guide Initializer

Name: Agent Guide Initializer
Author: OpenHands

byOpenHands

•

Learning & Documentation

Scaffolds project-specific AGENTS.md files to provide clear guidelines and context for AI agents working within a repository.

The Agent Guide Initializer skill streamlines the process of making a repository AI-ready by creating a standardized AGENTS.md contributor guide. When triggered, it automatically inspects the repository's structure, primary documentation, build tooling, and test suites to generate a concise reference tailored to the specific project. This ensures that any AI assistant or agent interacting with the codebase has immediate access to critical context, naming conventions, and development workflows, significantly reducing errors and improving alignment with project standards.

Key Features

01Optimized markdown output designed for AI agent consumption

02Support for root-level or subdirectory-scoped initialization

0372 GitHub stars

04Automated repository inspection for tailored guideline generation

05Smart file protection to prevent accidental overwrites

06Structured templates covering build, test, and coding standards

Use Cases

01Standardizing contributor guidelines for AI-human collaboration

02Adding localized context for specific sub-modules or monorepo packages

03Setting up a new repository to be AI-agent friendly

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add openhands/extensions init

For use in Claude.ai and ChatGPT

Download Skill