skill-review

Validate agent skills' structure, frontmatter, description quality, and anti-patterns, outputting a structured report.

69|11|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/richtabor/agent-skills --skill skill-review-richtabor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-review
Source: https://github.com/richtabor/agent-skills/tree/main/skills/skill-review
Command: npx skills add https://github.com/richtabor/agent-skills --skill skill-review-richtabor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Validates agent skills against the Agent Skills standard and compiled best practices to ensure consistent structure, quality, and reliable activation.

Core Features & Use Cases

  • Structural audit: checks for SKILL.md presence, correct directory layout, and required references/scripts.
  • Frontmatter and description validation: enforces naming, description length, and trigger phrases to improve discoverability.
  • Quality scoring and anti-pattern detection: evaluates description, body content, and detects common pitfalls, producing a structured report with actionable rewrites.
  • Use cases: ideal for auditing new or edited skills before publishing to ensure alignment with standards.

Quick Start

Review a target skill by pointing this skill at its SKILL.md file or a skill directory.

Frequently Asked Questions about skill-review

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

FAQPage Schema
How do I audit agent skills for best-practice compliance and structure validation?

You audit agent skills for best-practice compliance by running a structural audit that checks directory layout, SKILL.md presence, frontmatter validation, description quality, and anti-patterns to produce a structured report.

What are common anti-patterns to check for during agent skill creation?

Common anti-patterns detected during agent skill creation involve frontmatter naming violations, incorrect description length, missing trigger phrases, poor body content quality, and incorrect directory structure.

How do I validate frontmatter and description quality in a skill directory?

Frontmatter and description quality validation enforces correct naming conventions, description length limits, and trigger phrases by analyzing the skill directory contents to improve discoverability.

Can I use a structure audit to check SKILL.md presence and required references before publishing?

Yes, a structure audit checks for SKILL.md presence, correct directory layout, and required references or scripts, making it ideal for auditing new or edited skills before publishing.

Does agent skill validation require any external dependencies or scripts?

Agent skill validation requires no external dependencies or scripts, operating independently to load references, run structural audits, and output a quality report with actionable rewrites.

Why does my agent skill fail the structure audit when editing the directory layout?

Agent skill structure audits fail when the directory layout lacks SKILL.md presence, required references, or correct formatting, flagging these anti-patterns in a structured report for correction.