agents-md-generator
AGENTS.md / CLAUDE.md Generator
Overview
This skill helps you generate comprehensive instruction files (AGENTS.md with optional CLAUDE.md compatibility) that teach AI coding agents how to work effectively in your project. It combines automatic project scanning with interactive questions to create tailored guidelines.
When to use this skill:
- Setting up a new project for AI-assisted development
- Updating existing instruction files after project changes
- Standardizing AI agent behavior across team members
- Migrating from one AI tool to another
Key Principle
Do not duplicate specialized skills. If a request falls into a specialized domain (e.g., Design System), delegate to the specialized skill when available.
Use AGENTS.md as the shared project manual. AGENTS.md is plain Markdown with no required fields. Cover the details an agent needs to work effectively: project overview, build and test commands, code style, testing expectations, security notes, PR/commit rules, and deployment gotchas.
Encode source-of-truth and reuse-first rules. Generated project instructions should tell agents to read local docs/config/source before coding, verify same-name files by path and imports, reuse existing components/services/helpers/tokens before creating new ones, and keep files cohesive instead of adding large mixed-concern files.