Agent skill · writing content · madteacher
agents-md-generator
Create, generate, update, repair, trim, or split minimal AGENTS.md files for repository roots and confirmed nested modules using progressive disclosure. Use for missing, bloated, contradictory, or outdated agent instructions, monorepos, services, packages, module context, and portable agent guidance without assuming any fixed agent folder structure.
Why this skill is useful
Provides a structured approach to generating and maintaining AGENTS.md files, which includes specific templates and workflows that the AI wouldn't reliably generate on its own.
What it needs
About 3k tokens when loaded. Last updated 2026-05-01. 104 stars on the source repository.
What this skill does
AGENTS.md Generator (Root + Nested, Portable) Goal Maintain small, high-signal AGENTS.md files: Root AGENTS.md — purpose of repository, navigation, universal toolchain, canonical commands, links to docs and skills. Nested AGENTS.md — module/package purpose, local commands, module references. Use progressive disclosure: keep AGENTS.md concise; push details to docs or skills. --- Skill location (agent-specific) Do NOT assume .agents/ or any fixed directory exists. Skills may live: inside the repository (embedded), or in an external/global skill library (external). If referencing local skills, use only an existing skill root already used by the project or an existing project path already mentioned by repo docs. If no local skill directory exists — reference skills by name only (external). Never create hidden agent directories just to store skills. --- Resource Routing Use templates as skeletons, not literal output: Read references/AGENTSTEMPLATEROOT.md only when creating or updating the root AGENTS.md. Read references/AGENTSTEMPLATEMODULE.md only after a directory is confirmed as a nested module that needs its own AGENTS.md. Replace or remove every placeholder. Final AGENTS.md files must not contain unresolved <...> template markers. --- When to run Run this skill when: AGENTS.md is missing, bloated, contradictory, or outdated. AGENTS.md needs to be generated, repaired, trimmed, split, or updated. A new package/service/module appears. Repository structure changes (monorepo growth or split). Teams want consistent agent context across diverse stacks. --- Workflow (Deterministic) 1. Discover repository shape Identify repository root (git root if available). Detect language/tool markers: package.json, pnpm-workspace.yaml go.mod, go.work pyproject.toml Cargo.toml pubspec.yaml pom.xml, build.gradle Locate docs/, README.md, existing AGENTS.md. --- 2. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills madteacher/agents-md-generator