skill-agent-review

skill-agent-review

A Claude Code plugin bundling two checklist-driven review skills:

• review-skill — audits a skill directory (SKILL.md + bundled scripts/, references/, assets/) against the Agent Skills specification and best-practices guidelines. Mechanical spec checks run via a bundled Node script; judgment items are graded against a fixed checklist, every item getting exactly one evidence-backed verdict.
• review-agent — audits a subagent definition file (agents/*.md) against the documented subagent format and best practices, including the seam with any skill it binds to (duty segregation, pointer-not-copy, actor-neutral skill content).

Both skills produce a filled-in checklist — no prose findings, no invented issues. A well-built target legitimately passes everything.

Requirements

Node.js 18+ (for the bundled mechanical checkers).

Install

Add the marketplace and install the plugin from within Claude Code:

/plugin marketplace add gdanov/skill-agent-review
/plugin install skill-agent-review@skill-agent-review-marketplace

Use

Ask Claude to review a skill or agent, e.g. "review the skill in skills/pdf-tools" or "audit agents/reviewer.md against best practices". The matching skill loads automatically; you can also invoke them explicitly with /review-skill or /review-agent.