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.md or CLAUDE.md (default to a single root file; see Core Rules)
  • improve, review, or rewrite an existing one
  • design or audit a layered AGENTS.md hierarchy 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.md into 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
Installs
19
First Seen
May 20, 2026
improve-agents-md — ciel-yu/agent-skills