agents-md-generator
Generate hierarchical AGENTS.md structures for codebases. Use when user asks to create AGENTS.md files, analyze codebase for AI agent documentation, set up AI-friendly project documentation, or generate context files for AI coding assistants. Triggers on "create AGENTS.md", "generate agents", "analyze codebase for AI", "AI documentation setup", "hierarchical agents".
npx skills add majiayu000/claude-skill-registry --skill agents-md-generator-araaking-opencode-kuli-pro --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# AGENTS.md Generator Generate hierarchical AGENTS.md structures optimized for AI coding agents with minimal token usage. ## Core Principles 1. **Root AGENTS.md is LIGHTWEIGHT** - Only universal guidance, links to sub-files (~100-200 lines max) 2. **Nearest-wins hierarchy** - Agents read closest AGENTS.md to file being edited 3. **JIT indexing** - Provide paths/globs/commands, NOT full content 4. **Token efficiency** - Small, actionable guidance over encyclopedic docs 5. **Sub-folder files have MORE detail** - Specific patterns, examples, commands ## Workflow ### Phase 1: Repository Analysis Analyze and report: 1. **Repository type**: Monorepo, multi-package, or simple? 2. **Tech stack**: Languages, frameworks, key tools 3. **Major directories** needing own AGENTS.md: - Apps (`apps/web`, `apps/api`, `apps/mobile`) - Services (`services/auth`, `services/transcribe`) - Packages (`packages/ui`, `packages/shared`) - Workers (`workers/queue`, `workers/cron`) 4. **Build system**: pnpm/npm/yarn workspaces? Turborepo? Lerna? 5. **Testing setup**: Jest, Vitest, Playwright, pytest? 6. **Key patterns**: Organization, conventions, examples, anti-patterns Present as structured map before genera
- Core Principles
- Workflow
- Phase 1: Repository Analysis
- Phase 2: Root AGENTS.md
- Phase 3: Sub-Folder AGENTS.md
- Phase 4: Special Templates
- Output Format
- Quality Checklist
What does the agents-md-generator skill do?
Generate hierarchical AGENTS.md structures for codebases. Use when user asks to create AGENTS.md files, analyze codebase for AI agent documentation, set up AI-friendly project documentation, or generate context files for AI coding assistants. Triggers on "create AGENTS.md", "generate agents", "analyze codebase for AI", "AI documentation setup", "hierarchical agents".
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agents-md-generator-araaking-opencode-kuli-pro --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.