skills

Writes (generates or updates) AGENTS.md — a token-efficient context file for AI coding agents. Analyzes project stack, constraints, and commands. Produces AGENTS.md and agent-specific imports (CLAUDE.md, .cursorrules, GEMINI.md, etc.). Preserves curated sections on update. Also reviews an existing AGENTS.md read-only (runs the bundled critic; writes nothing). Use when: the user asks to create, update, or review AGENTS.md, CLAUDE.md, or agent context files; or to onboard an AI agent to a project.

Reviews and grades an agent skill directory (SKILL.md plus supporting resources) for specification compliance, clarity, token efficiency, safety, robustness, and portability. Produces an evidence-cited weighted score and grade, P1/P2/P3 findings with minimal patch text, and a machine-readable verdict with structured findings for generator-critic loops. Offers full, triage, and incremental review depths; single, batch, comparative, forensic, and ensemble modes; and an opt-in behavioral probe. Use when a user wants a skill folder reviewed, graded, audited, or compared. Not for writing or refactoring skills (use writing-skills).

Creates or updates professional-grade agent skills (SKILL.md + optional scripts/references/assets) with strict validation and an iterative generator↔critic workflow. Use when: you want a new skill, want to refactor an existing skill for clarity/token-efficiency, or want to reach an A-grade rubric score. Not for reviewing or grading a skill (use reviewing-skills), or for authoring rubrics (writing-rubrics), specs (writing-specs), designs (writing-designs), or AGENTS.md (writing-agents-md).

Creates or updates rubric Markdown files (and their review-template/prompt integration) with consistent grade bands, P1/P2/P3 definitions, and evidence-backed verification rules. Use when: the user asks to add a new rubric, align/consolidate rubrics, or sync rubric expectations with reviewer templates/prompts.