skill-reviewer

Original：🇨🇳 Chinese
Translated

We review Claude Code Skills based on official best practices and provide specific improvement suggestions. It is triggered by requests such as 'Review this skill', 'Check skill quality', 'Validate SKILL.md', 'I want to improve this skill'.

1installs
Sourcetukaelu/agent-skills
Added on

NPX Install

npx skill4agent add tukaelu/agent-skills skill-reviewer

Tags

Translated version includes tags in frontmatter
claude-code-skillskill-reviewbest-practicesimprovement-recommendationsinteractive-fixes

SKILL.md Content (Chinese)

View Translation Comparison →

Skill Reviewer

Review skills based on official best practices and provide specific improvement suggestions.

Review Workflow

Step 1: Identify the Target Skill

Identify the SKILL.md file to be reviewed:
  • Use the path directly specified by the user if provided
  • Search for SKILL.md in the current directory
  • If multiple skills exist, let the user select via AskUserQuestion (max 4 items. For more than that, use 'Other' for direct input)

Step 2: Loading and Analysis

  1. Fully load the target SKILL.md file
  2. Check the checklist in best-practices.md

Step 3: Alignment with Best Practices

Evaluate against each category in best-practices.md.

Step 4: Generate Review Report

Output in the following format:
markdown
# Skill Review Report: {skill-name}

## Summary
- Overall Rating: {PASS | NEEDS_IMPROVEMENT | CRITICAL_ISSUES}
- Critical: {count}
- Warning: {count}
- Info: {count}

## Critical (Must Fix)
{List of issues requiring mandatory fixes}

## Warning (Recommended Fixes)
{List of recommended improvements}

## Info (Improvement Suggestions)
{List of optional enhancements}

## Specific Recommendations
{Specific action items including examples}

Step 5: Interactive Improvement

After presenting the report, confirm the user's intention to make fixes via AskUserQuestion:
javascript
AskUserQuestion({
  questions: [{
    question: "Would you like to fix the identified issues?",
    header: "Correction Strategy",
    options: [
      { label: "Fix while confirming one by one", description: "Proceed with proposals and confirmations one item at a time (Recommended)" },
      { label: "Fix only Critical issues",      description: "Automatically apply only mandatory fixes" },
      { label: "Fix all automatically",         description: "Fix all issues without confirmation" },
      { label: "Do not fix",             description: "Only refer to the report" }
    ],
    multiSelect: false
  }]
})
Rules for correction:
  • Prioritize Critical issues
  • Apply fixes incrementally
  • Re-verify after each fix: Re-read the corrected SKILL.md with Read and check if the corresponding item meets the checklist in best-practices.md