skill-review

Validate SKILL.md files against framework v1.2 with phased reviews.

3|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/marcoguillermaz/claude-dev-kit --skill skill-review-marcoguillermaz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-review
Source: https://github.com/marcoguillermaz/claude-dev-kit/tree/main/packages/cli/templates/tier-m/.claude/skills/skill-review
Command: npx skills add https://github.com/marcoguillermaz/claude-dev-kit --skill skill-review-marcoguillermaz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Lightweight orchestration for validating SKILL.md against the framework v1.2, enabling consistent, governance-driven skill-quality reviews in small portfolios.

Core Features & Use Cases

  • Phase 1 mechanical preflight checks
  • Phase 2 structural + interactive walkthrough
  • Phase 3 fix + rollback with up to 3 attempts
  • Phase 6 closeout; supports STOP gates; handles tier M portfolio
  • Supports loading of supporting docs: REVIEW_FRAMEWORK.md, SEVERITY_SCALE.md, SPEC_SNAPSHOT.md, SKILLS_INVENTORY.md, CALIBRATION_KIT.md
  • Suitable for portfolios with 2-5 skills; auto-skipping Phase 4 and Phase 9; gating for cross-tier diffs

Quick Start

Run the lite-mode skill review for a target skill by specifying the skill name and tier.

Frequently Asked Questions about skill-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate SKILL.md files for frontmatter compliance and governance?

Validate SKILL.md files by running a skill-review against framework v1.2, which enforces frontmatter compliance, cross-tier coherence, and generates a structured findings report for governance. It runs Phase 1 through Phase 3 with interactive walkthroughs and STOP gates.

What is the best way to run a lightweight skill-quality review for a small portfolio?

Run a lightweight skill-quality review for small portfolios of 2-5 skills using a lite-mode validation that executes Phase 1 through Phase 3. It auto-skips Phase 4 and Phase 9 while enforcing cross-tier coherence and providing interactive walkthroughs with STOP gates.

How does the STOP gate mechanism work during an interactive skill walkthrough?

STOP gates act as enforcement checkpoints during the interactive walkthrough and fix phases, pausing the pipeline to prevent progression until validation criteria are met. They support structured rollback with up to 3 attempts during Phase 3 fixes.

What supporting documents do I need to load for a framework v1.2 skill review?

A framework v1.2 skill review supports loading REVIEW_FRAMEWORK.md, SEVERITY_SCALE.md, SPEC_SNAPSHOT.md, SKILLS_INVENTORY.md, and CALIBRATION_KIT.md to provide calibration context, severity definitions, and inventory tracking for the validation process.