skills.rest
sujithatzackriya
sujithatzackriyaCOMMUNITY
Explore all skills by this author →
GitHub

skill-review

Audit Claude skill folders for authoring rule compliance and routing readiness.

Updated Aug 27, 2026
Search Tags:#progressive disclosure#documentation quality#YAML frontmatter#skill auditing#prompt routing#compliance checks#trigger coverage
One-click install
npx skills add https://github.com/sujithatzackriya/skills --skill skill-review-sujithatzackriya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-review
Source: https://github.com/sujithatzackriya/skills/tree/main/skills/skill-review
Command: npx skills add https://github.com/sujithatzackriya/skills --skill skill-review-sujithatzackriya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Skill review automates auditing a Claude skill folder to ensure it is well-formed, correctly routable, and compliant with Anthropic’s Complete Guide to Building Skills for Claude.

Core Features & Use Cases

  • Audits the target skill’s SKILL.md frontmatter and body structure, including naming, description quality, triggers, and progressive disclosure.
  • Checks the entire skill directory for layout and integrity issues, including invalid/misnamed files, stray artifacts, and broken internal reference links.
  • Produces a severity-tagged report with concrete fix suggestions (BLOCK/HIGH/MED/LOW/NIT) suitable for publishing readiness review.
  • Use cases: validating a new skill submission, verifying routing behavior before upload, and improving consistency with the authoring guide.
  • Not intended for PR code review; use the repository’s PR review skills for that.

Quick Start

Use the command /skill-review and provide the skill folder path you want audited (or use /skill-review with no args to be prompted).

Frequently Asked Questions about skill-review

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

FAQPage Schema
How do I audit a Claude skill folder for compliance and routing readiness?▼

Auditing a Claude skill folder involves checking the SKILL.md frontmatter, validating directory structure, and running rule checks against authoring guidelines. This skill reviews your folder and produces a severity-tagged remediation report for publishing readiness.

What does progressive disclosure validation check in a SKILL.md file?▼

Progressive disclosure validation checks the SKILL.md body structure to ensure naming, description quality, and triggers comply with Anthropic's skill authoring rules. It verifies your skill is correctly structured for routing and deployment.

Can I run a comprehensive audit over all skills in a directory?▼

Yes, you can run comprehensive audits over all skills under the ./skills/ directory. The skill reads each folder's SKILL.md frontmatter and full directory contents to check layout integrity and identify stray artifacts.

How do I fix broken internal reference links in a skill directory?▼

Fixing broken internal reference links requires auditing the entire skill directory layout. This skill detects invalid or misnamed files and broken links, then produces a report with concrete fix suggestions tagged by severity.

Is this skill suitable for PR code review?▼

No, this skill is not intended for PR code review. It specifically audits Claude skill folders for correctness, routing readiness, and compliance with skill authoring rules; use your repository's PR review skills for code review instead.

What severity levels are used in the skill auditing remediation report?▼

The skill auditing remediation report uses BLOCK, HIGH, MED, LOW, and NIT severity tags. These levels help prioritize fixes for invalid files, frontmatter issues, and compliance gaps before publishing.

Related Skills

Explore More Product & Management Skills→
emliunixemliunix

CWD Test Skill

Run a Skill from its current directory using YAML frontmatter metadata.

Community
Basic
majiayu000majiayu000
12

skill

Route user requests to registered skill modules and execute them in context.

Community
Basic
samuelfajsamuelfaj
1

sam-review-pr

Automate end-to-end PR/MR reviews across GitHub and GitLab.

Community
Advanced
taisukeoetaisukeoe
2

reviewing-skills

Review agent skills against Claude best practices for compliance and structure.

Community
Intermediate