skill-review

Audit Agent Skill directories against the Agent Skills Specification and quality criteria.

2|Updated Mar 1, 2026

Search Tags:#quality assurance #specification #validation #agent skills #skill audit #compliance check

Ready to run

npx skills add https://github.com/synapseradio/ai-skills --skill skill-review-synapseradio

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-review
Source: https://github.com/synapseradio/ai-skills/tree/main/skills/skill-review
Command: npx skills add https://github.com/synapseradio/ai-skills --skill skill-review-synapseradio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the rigorous auditing of Agent Skill directories, ensuring they meet the official specification and quality standards, thereby improving the reliability and trustworthiness of AI skills.

Core Features & Use Cases

Comprehensive Auditing: Validates skills against a detailed checklist covering frontmatter, references, scripts, structure, and README completeness.
Automated Reporting: Generates a structured pass/fail report with specific instructions for any identified failures.
Use Case: Before publishing a new skill or integrating a third-party skill, run skill-review to ensure it adheres to all best practices and specifications, preventing potential issues down the line.

Quick Start

Use the skill-review skill to audit the skill located at ~/.claude/skills/my-skill/.

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 specification compliance and quality?▼

To validate agent skills, run an automated audit against the specification covering frontmatter, progressive disclosure, URL reachability, script standards, README completeness, and workflow metadata criteria.

What is an agent skill compliance check?▼

An agent skill compliance check is an automated validation process that audits skill directories against the official specification and quality criteria, producing a structured pass/fail report with specific fix instructions.

How do I validate frontmatter and script standards in a skill directory?▼

To validate frontmatter and script standards, run an automated audit on the skill directory which checks these components against the specification and outputs structured pass/fail results with targeted fix instructions.

Does skill audit check URL reachability and README completeness?▼

Yes, skill audit checks URL reachability and README completeness as part of its comprehensive validation process, automatically verifying these elements against the specification and generating specific fix instructions for any failures.

What's the best way to ensure third-party skills meet quality assurance criteria?▼

The best way to ensure third-party skills meet quality assurance criteria is to run an automated audit before integration, validating the skill directory against the official specification and generating a structured pass/fail report.

When do I need to run a specification validation on agent skills?▼

You need to run a specification validation on agent skills before publishing a new skill or integrating a third-party skill, ensuring it adheres to best practices and preventing potential issues down the line.