reviewing-skills
Installation
SKILL.md
Reviewing Skills
Objective
Evaluate a skill directory as if you are an AI agent encountering it for the first time. Produce a read-only review with:
- A weighted score + letter grade, derived from itemized rubric checks with cited evidence
- Spec violations (blockers) — every blocker is also recorded as a P1 finding
- Prioritized findings (P1/P2/P3) with concrete, minimal fixes and confidence levels
- A machine-readable verdict block (scores, blockers, and structured findings) for automation
- Rewritten sections only when needed to reach the quality bar
This skill acts as the critic in a generator↔critic loop (e.g., with $writing-skills).
When to use / When not to use
Use when:
- The user asks to review, grade, audit, or compare skill folders containing
SKILL.md. - The user wants rubric-based scoring and actionable edits (not just general advice).