agents-md-generator

Generate standardized AGENTS.md files from repository structure analysis.

18|3|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/buYoung/skills --skill agents-md-generator-buyoung
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-md-generator
Source: https://github.com/buYoung/skills/tree/main/skills/agents-md-generator
Command: npx skills add https://github.com/buYoung/skills --skill agents-md-generator-buyoung

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Analyze repository structure and generate standardized AGENTS.md files that serve as contributor guides for AI agents. This includes handling both single-repo and monorepo setups, measuring LOC to determine a dynamic character budget, and producing sections for overview, folder structure, patterns, conventions, and working agreements.

Core Features & Use Cases

  • Automatically analyzes repository structure (single-repo or monorepo) and generates a comprehensive AGENTS.md with sections for Overview, Folder Structure, Core Behaviors & Patterns, Conventions, and Working Agreements.
  • Updates existing AGENTS.md by refreshing standard sections while preserving user-defined custom content, and reports externally authored files.
  • Detects monorepo layouts and applies appropriate per-package documentation strategies.
  • Integrates LOC-based character budgeting and batch generation to support scalable documentation.

Quick Start

Run the skill on a repository directory to generate or refresh its AGENTS.md.

Frequently Asked Questions about agents-md-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an AGENTS.md file for my repository?

To generate an AGENTS.md file, you run this skill on your repository directory to analyze the structure and automatically produce standardized sections for overview, folder structure, conventions, and working agreements that guide AI agents.

What is AGENTS.md and when do I need it for AI agent collaboration?

AGENTS.md is a standardized contributor guide for AI agents. You need it when integrating AI into your workflow to provide structured context about repository patterns, conventions, and core behaviors for automated collaboration.

Does AGENTS.md generation work for monorepo structures?

Yes, AGENTS.md generation works for monorepo structures. It detects monorepo layouts and applies appropriate per-package documentation strategies, ensuring each package receives contextually relevant documentation for AI agents.

Can I refresh AGENTS.md without losing my custom content?

You can refresh AGENTS.md without losing custom content. The skill updates only managed standard sections while preserving user-defined custom content, and reports externally authored files without modification.

How does repository analysis handle large codebases when generating documentation?

Repository analysis handles large codebases by measuring lines of code to determine a dynamic character budget and applying batch generation, ensuring scalable and contextually appropriate AGENTS.md documentation generation.

What happens if my repository already has an externally authored AGENTS.md?

If your repository has an externally authored AGENTS.md, the skill reports the file without modification. It only updates managed sections or generates new files to avoid overwriting existing manual configurations.