agents-md-refactor
Refactor an existing AGENTS.md that is too long, has too much inline content, or lacks nested structure. Use when the user says "my AGENTS.md is too long", "split my AGENTS.md", "optimize my context file", "refactor AGENTS.md", or "/agents-md:refactor". Analyzes the file, proposes a split plan, and executes it — creating nested AGENTS.md files and slimming the root file. Distinct from agents-md:check (audit only) and agents-md:create (greenfield).
Repository SourceNeeds Review
skill-refactor
Refactor a SKILL.md that is too long or lacks Progressive Disclosure structure. Shrinks the body to under 100 lines by extracting detail into references/ files. Use when the user says "my skill is too long", "refactor my skill", "apply progressive disclosure to my skill", "slim down my SKILL.md", "/skill:refactor", or after /skill:check reports FAIL/WARN. Distinct from skill:check (audit only).
Repository SourceNeeds Review
skill-check
Audit a SKILL.md for structure and UX quality — checks line count, progressive disclosure, frontmatter, references usage, output format, help flag pattern, step structure, options docs, verdict output, and next-action hints. Use when the user says "check my skill", "audit my skill", "does this skill follow best practices?", "/skill:check". Reports PASS/WARN/FAIL/N/A per criterion with concrete fixes. Do NOT use for AGENTS.md or CLAUDE.md files — use agents-md:check or claude-md-check instead.
Repository SourceNeeds Review
agents-md-check
Audit an existing AGENTS.md file for compliance with project documentation standards. Use when the user asks to check, validate, review, or audit an AGENTS.md file — including "is my AGENTS.md good?", "check my context file", "does this follow standards?", or "/agents-md:check". Reports pass/fail/warn per criterion with concrete improvement suggestions. Do NOT use for CLAUDE.md orchestrator files — use claude-md:check instead.
Repository SourceNeeds Review