improve-agents-md
Installation
SKILL.md
Improve AGENTS.md
Create, critique, or rewrite AGENTS.md / CLAUDE.md into a cross-session operator contract, not a prompt dump. This skill is a Reviewer + Generator + Pipeline: analyze mode diagnoses and proposes without editing files; rewrite mode implements; both require a classification step before proceeding.
Use When
Use when the user asks to:
- create a new
AGENTS.mdorCLAUDE.md(default to a single root file; see Core Rules) - improve, review, or rewrite an existing one
- design or audit a layered
AGENTS.mdhierarchy in a monorepo or multi-project repo - decide what belongs in root vs a project-level
AGENTS.md - resolve duplication between root and nested instruction files
- convert a large
AGENTS.mdinto a layered setup - extract task-specific guidance from a root instruction file
- remove transient work-state content from a root instruction file
- clarify current direction when a repo has competing historical patterns