claude-skill-review

Audit Claude Code SKILL.md files for guideline compliance and quality.

3|Updated Sep 29, 2025
One-click install
npx skills add https://github.com/xtone/ai_development_tools --skill claude-skill-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-skill-review
Source: https://github.com/xtone/ai_development_tools/tree/main/.claude/skills/claude-skill-review
Command: npx skills add https://github.com/xtone/ai_development_tools --skill claude-skill-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides automated quality review for Claude Code SKILL.md files to ensure they meet official guidelines and help maintainers catch issues before release.

Core Features & Use Cases

  • Frontmatter validation: verifies required fields (name and description) and checks constraints such as length, character set, and reserved words.
  • Structure and references validation: ensures the directory layout matches marketplace guidelines and that referenced files exist if present.
  • Body quality assessment: evaluates the SKILL.md body for length, the presence of examples, a clear workflow, and consistent terminology.
  • Reference file verification: checks that referenced files exist at the expected paths (level-1 depth) when present.
  • Safety and quality enforcement: flags potential prompt-injection or data-exfiltration concerns in instructions and content.

Quick Start

Run the review against a target SKILL.md path, e.g. .claude/skills/claude-skill-review/SKILL.md, to obtain a structured quality report.

Frequently Asked Questions about claude-skill-review

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

FAQPage Schema
How do I review a Claude Code SKILL.md file for marketplace compliance?

To review a Claude Code SKILL.md file for marketplace compliance, run an audit against the target file path to verify frontmatter fields, directory structure, body length, and reference materials, generating a structured quality report.

What makes a valid SKILL.md frontmatter for Claude Code skills?

Valid SKILL.md frontmatter requires specific fields like name and description, while enforcing constraints on character length, allowed character sets, and reserved words to ensure Claude Code skills meet official guidelines.

How do I check SKILL.md reference files and directory structure before a pull request?

Checking SKILL.md reference files and directory structure involves verifying that the layout matches marketplace guidelines and validating that any referenced files exist at the expected level-1 depth paths during a pull request review.

Can I automate prompt-injection detection in Claude Code skill instructions?

You can automate prompt-injection detection in Claude Code skill instructions by running a safety audit that flags potential prompt-injection or data-exfiltration concerns within the SKILL.md content and its instructions.

What are the body length requirements for a Claude Code SKILL.md file?

Body length requirements for a Claude Code SKILL.md file dictate that the content must meet specific length thresholds, include clear examples, maintain consistent terminology, and define a clear workflow to pass quality assessment.

When should I use an automated SKILL.md linter over manual review?

You should use an automated SKILL.md linter over manual review when pre-validating new skills before marketplace submission or during PR reviews, ensuring consistent enforcement of structural and safety constraints without human error.