Agent skill · writing content · thienanblog
agents-md-generator
Coordinator-routed specialist for creating, auditing, compacting, or restructuring AGENTS.md, AGENTS.override.md, nested instructions, or optional CLAUDE.md compatibility files. Use after project-development-mindset identifies repository instructions as the primary deliverable, or directly when explicitly invoked or installed standalone. Do not use for routine instruction reading or a small required update accompanying code.
Why this skill is useful
Adds specific project instruction generation patterns and workflows that the AI wouldn't reliably generate on its own.
What it needs
About 6k tokens when loaded. Last updated 2026-08-05. 63 stars on the source repository.
What this skill does
AGENTS.md Generator Create a small, project-specific instruction layer that agents can load on every task. Treat context as a limited budget: include durable rules that materially change agent behavior, and leave general engineering knowledge or detailed documentation out. Run this skill in the main conversation. Do not use subagents unless the user explicitly approves the proposed agent count and scope after being warned that delegation can increase usage. Ask again before expanding an approved scope. Core contract Prefer AGENTS.md as the shared repository instruction file. Generate only files the user requested. Ask before adding a compatibility file for another tool. Keep the root file broadly applicable. Put subtree-specific rules in nested instruction files only when the target tool supports them. Record verified facts, not assumptions or generic best practices. Link to detailed project documentation with a task-specific read condition instead of copying it. Never store secrets, credentials, private prompts, conversation transcripts, or the user's verbatim request. Do not add tool configuration directories to .gitignore wholesale. Some contain intentionally versioned project configuration. Do not modify global instruction files or user configuration while generating repository instructions. Output budget Use these defaults unless the repository already has a stricter convention: Root AGENTS.md: target 80-150 lines and at most 12 KiB. Root hard review threshold: 200 lines or 16 KiB. Nested instruction file: target at most 80 lines and include only differences from the parent scope. CLAUDE.md compatibility file: normally one import line plus explicitly requested Claude-specific rules. If a generated or merged root file crosses either hard threshold, compact it before writing. Never justify an oversized file by raising Codex's projectdocmaxbytes; that setting is an escape hatch, not the default design. Workflow 1. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills thienanblog/agents-md-generator--dcba04