review-skill

Audit and fix Claude Code SKILL.md files against a tiered checklist.

3|1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/smykla-skalski/sai --skill review-skill-smykla-skalski
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-skill
Source: https://github.com/smykla-skalski/sai/tree/main/review-skill/skills/review-skill
Command: npx skills add https://github.com/smykla-skalski/sai --skill review-skill-smykla-skalski

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the auditing and correction of Claude Code skill definitions (SKILL.md files), ensuring they meet quality standards and best practices.

Core Features & Use Cases

  • Automated Auditing: Checks skills against a tiered checklist (Critical, Important, Polish).
  • Automated Fixing: Corrects identified issues in SKILL.md and bundled resources.
  • Use Case: Before publishing a new skill, use this to ensure it adheres to Anthropic's best practices, improving its reliability and discoverability.

Quick Start

Use the review-skill skill to audit and fix the skill definition located at skills/my-new-skill.

Frequently Asked Questions about review-skill

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

FAQPage Schema
How do I audit a Claude Code skill definition against best practices?

To audit a Claude Code skill definition, you validate its SKILL.md file against a tiered binary checklist covering Critical, Important, and Polish levels. This automated review enforces Anthropic best practices, frontmatter compliance, directory structure, and script invocation.

What does skill validation check for in an Agent Skills specification?

Skill validation checks Agent Skills specification compliance by reviewing frontmatter, directory structure, script invocation, and resource referencing. It identifies issues across a tiered checklist and enforces community guidelines for skill quality.

Can I automatically fix non-compliant SKILL.md files?

Yes, you can automatically fix non-compliant SKILL.md files. The automated fixing feature corrects identified issues in skill definitions and bundled resources after validating them against Anthropic's best practices and the tiered checklist.

How do I validate skill frontmatter and directory structure before publishing?

You validate skill frontmatter and directory structure by running an automated code audit against a tiered binary checklist. This process checks resource referencing and script invocation to ensure reliability and discoverability before publication.

What are the limitations of automated skill review for SKILL.md files?

The limitations of automated skill review involve its dependency on a binary checklist system. While it validates frontmatter, directory structure, and script invocation, it focuses on specification compliance rather than subjective quality or functional logic testing.

Does the review-skill audit work with bundled resources and scripts?

Yes, the review-skill audit works with bundled resources and scripts. It validates script invocation and resource referencing within the directory structure, and the automated fixing feature corrects identified issues across these bundled components.