improve-agents-md
Generate and update AGENTS.md (CLAUDE.md) for projects using a single template with dynamic per-type tooling injection. Auto-detects project type and renders the appropriate Environment & Tooling section. Triggers on keywords: improve agents, generate agents.md, update agents.md, setup claude.md, bootstrap agents
npx skills add majiayu000/claude-skill-registry --skill improve-agents-md --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# improve-agents-md Generate and manage AGENTS.md (rendered as CLAUDE.md) using a single base template with dynamic tooling values from `tooling.yml`. ## Architecture ``` assets/ AGENTS.md.template # Single base template with {{VAR}} placeholders tooling.yml # Per-type tooling values (package_manager, linter, etc.) extras/pep723.md # Optional section injected for Python types templates/shared/ # Shared templates (.gitignore) tools/ bootstrap.py # Entrypoint: setup, update, validate template_engine.py # Reads tooling.yml, renders template, injects extras project_type.py # Auto-detect project type from file indicators preserve_custom.py # Backup + CLAUDE.md migration detection ``` ## Modes ### setup Generate AGENTS.md for a project: 1. Detect project type (or accept `--type` override) 2. Back up existing files if `--force` 3. Load tooling values from `tooling.yml` for detected type 4. Render `AGENTS.md.template` with tooling substitution 5. Inject extras (e.g., PEP 723 section for Python types) 6. Write rendered AGENTS.md to project root 7. Create CLAUDE.md and GEMINI.md as symlinks to AGENTS.md ### update Re-render AGENTS.md with latest template: 1. Re-detect project type (or accept
- Architecture
- Modes
- setup
- update
- validate
- Flags
- Dynamic Rendering
- Extras Injection
- Questionnaire
- Supported Project Types
- Customization Preservation
What does the improve-agents-md skill do?
Generate and update AGENTS.md (CLAUDE.md) for projects using a single template with dynamic per-type tooling injection. Auto-detects project type and renders the appropriate Environment & Tooling section. Triggers on keywords: improve agents, generate agents.md, update agents.md, setup claude.md, bootstrap agents
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill improve-agents-md --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.