skill-review

Analyze SKILL.md files and output standardized review reports with recommendations.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/yuch4/dx-selecta --skill skill-review-yuch4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-review
Source: https://github.com/yuch4/dx-selecta/tree/main/.claude/skills/skill-review
Command: npx skills add https://github.com/yuch4/dx-selecta --skill skill-review-yuch4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This meta-skill audits the metadata, structure, and safety aspects of other SKILL.md entries under a given path to ensure they are discoverable, concise, and aligned with best practices.

Core Features & Use Cases

  • Audit Metadata: Verify frontmatter completeness (name, description) and ensure it follows naming conventions.
  • Quality & Safety Review: Evaluate description clarity, potential overlaps, progressive disclosure, and tooling constraints.
  • Output & Improvements: Produce a standardized review report with concrete edits and suggested restructures for each reviewed skill.

Quick Start

Run the skill-review on a target skill path, for example: .claude/skills/prd-writing/SKILL.md, to generate a review summary and recommended edits.

Frequently Asked Questions about skill-review

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

FAQPage Schema
How do I review SKILL.md files for metadata quality and safety?

To review SKILL.md files for metadata quality and safety, run this skill on a target skill path like .claude/skills/prd-writing/SKILL.md. It analyzes frontmatter completeness, description clarity, and tooling constraints, then outputs a standardized review report with actionable recommendations.

What is skill metadata best practices review for frontmatter and structure?

Skill metadata best practices review audits frontmatter completeness, bounded scope, and line-length considerations. It ensures skill definitions are discoverable, concise, and aligned with structural guidelines by checking proper naming conventions and progressive disclosure to avoid overlaps.

How do I audit skill definitions for discoverability and description clarity?

You can audit skill definitions for discoverability by evaluating frontmatter completeness and description clarity. This skill checks for proper metadata naming conventions, avoidance of overlap, and adherence to best practices, returning concrete edits and suggested restructures.

Does the skill review process check for bounded scope and safe tooling usage?

Yes, the skill review process checks for bounded scope and safe tooling usage. It evaluates potential overlaps, progressive disclosure, and tooling constraints to ensure skill definitions adhere to safety guidelines and quality best practices.

What's the best way to improve skill documentation structure and avoid overlap?

The best way to improve skill documentation structure is to run a standardized review that generates actionable recommendations. This skill evaluates progressive disclosure and bounded scope, producing a review summary with concrete edits and suggested restructures to eliminate overlapping definitions.

Why does my SKILL.md review report recommend frontmatter edits?

Your SKILL.md review report recommends frontmatter edits because it verifies that frontmatter completeness, including name and description fields, follows proper naming conventions. This ensures metadata quality and discoverability for your skill definitions.