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).
Installs
38
GitHub Stars
9
First Seen
Mar 1, 2026
reviewing-skills — jkeskikangas/skills