create-agents-md

Scaffold AGENTS.md and a structured docs skeleton for agent onboarding.

2|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/jonmumm/skills --skill create-agents-md-jonmumm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-agents-md
Source: https://github.com/jonmumm/skills/tree/main/create-agents-md
Command: npx skills add https://github.com/jonmumm/skills --skill create-agents-md-jonmumm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill bootstraps AGENTS.md and a structured docs/ directory to provide a concise, navigable map for agent-oriented projects, preventing monolithic instruction files.

Core Features & Use Cases

  • Bootstraps AGENTS.md as a table of contents pointing to deeper sources of truth in docs/
  • Creates a minimal docs/ skeleton with common catalogs like ARCHITECTURE.md, product-specs/index.md, acceptance/index.md, adrs/index.md, design-docs/index.md, and QUALITY.md
  • Supports progressive disclosure, so agents load only what they need on demand.

Quick Start

Create the starter AGENTS.md and a minimal docs/ structure tailored to the project.

Frequently Asked Questions about create-agents-md

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

FAQPage Schema
How do I create an AGENTS.md file for my project?

To create an AGENTS.md file, you can scaffold a starter template that acts as a table of contents pointing to deeper documentation sources, preventing monolithic instruction files and standardizing agent onboarding.

What is the best way to structure documentation for AI agents?

The best way to structure agent documentation is using progressive disclosure. Create a minimal docs skeleton with catalogs like ARCHITECTURE.md, product-specs, acceptance, ADRs, and QUALITY.md so agents load only what they need on demand.

How do I bootstrap a docs directory skeleton for a new project?

You can bootstrap a docs directory skeleton by generating a structured set of files including ARCHITECTURE.md, acceptance/index.md, adrs/index.md, design-docs/index.md, and QUALITY.md, ready for customization and progressive agent onboarding.

Can I customize the docs structure after scaffolding the AGENTS.md template?

Yes, the generated AGENTS.md and docs skeleton are starter templates ready for customization. The minimal structure provides common catalogs that you can tailor to fit your specific project requirements and team workflows.

When do I need an AGENTS.md file for my development team?

You need an AGENTS.md file when onboarding agents to new projects or when your team lacks centralized agent documentation. It provides a concise, navigable map that prevents monolithic instruction files and supports progressive disclosure.