Why is the 500-line limit important for SKILL.md?

Shorter, more focused skill files prevent context window bloat and help Claude process instructions more accurately without losing track of core logic.

What does a 'Critical' rating in the review report signify?

A Critical rating indicates issues that likely prevent the skill from functioning correctly, such as missing descriptions, security vulnerabilities, or severe structural errors.

What is the Reviewing Skills plugin?

It is a specialized capability for Claude Code designed to analyze and audit other custom skills to ensure they meet official quality and structural standards.

Does this skill automatically modify my code?

No, it generates a report first and then offers an interactive session where you can choose which improvements to apply step-by-step.

Claude Skill Quality Reviewer

Name: Claude Skill Quality Reviewer
Author: j5ik2o

byj5ik2o

•

开发者工具

Reviews and optimizes Claude Code skills based on official best practices and structural standards.

关于

The Reviewing Skills plugin provides an automated and interactive way to audit Claude Code skills for adherence to official documentation and implementation standards. It analyzes the SKILL.md file for proper YAML frontmatter, optimal line counts, progressive disclosure, and common anti-patterns. By generating detailed reports with actionable improvement suggestions, it ensures that your custom AI capabilities are reliable, maintainable, and highly effective for the Claude agent.

主要功能

Validates SKILL.md structure and YAML metadata accuracy
Audits content against official best practice checklists
Detects common anti-patterns like magic constants and lack of error handling
Generates categorized reports with Critical, Warning, and Info severity levels
Provides interactive, step-by-step improvement workflows to refine skill files
3 GitHub stars

使用场景

Standardizing custom Claude Code skills before sharing them within a development team
Troubleshooting underperforming skills by identifying structural or prompt-based issues
Refactoring large skill files to comply with the 500-line recommended limit for better agent performance

关于

主要功能

Validates SKILL.md structure and YAML metadata accuracy
Audits content against official best practice checklists
Detects common anti-patterns like magic constants and lack of error handling
Generates categorized reports with Critical, Warning, and Info severity levels
Provides interactive, step-by-step improvement workflows to refine skill files
3 GitHub stars

使用场景

Standardizing custom Claude Code skills before sharing them within a development team
Troubleshooting underperforming skills by identifying structural or prompt-based issues
Refactoring large skill files to comply with the 500-line recommended limit for better agent performance