Skill Improver

Execute improvement plans generated by skill-quality-reviewer to automatically update and fix issues in Claude Skills.

Core Workflow

Read improvement-plan-{name}.md
    ↓
Parse improvement items (High/Medium/Low priority)
    ↓
Group changes by file
    ↓
Detect and resolve conflicts
    ↓
Backup original files
    ↓
Execute updates (Edit or Write tools)
    ↓
Verify results
    ↓
Generate update-report

When to Use

Trigger phrases:

• "Apply improvements from improvement-plan-git-workflow.md"
• "Update my skill based on the quality report"
• "Execute the improvement plan for api-helper"
• "Fix the issues identified in quality review"

Use this skill when:

• Applying improvements from an improvement plan
• Updating a skill based on quality review feedback
• Executing recommended fixes from skill-quality-reviewer
• Implementing structured improvements to skill documentation

Step-by-Step Guide

Step 1: Load the Improvement Plan

Read the improvement-plan-{skill-name}.md file generated by skill-quality-reviewer.

# Plan is typically in current directory
ls improvement-plan-*.md

# Or specify full path
read /path/to/improvement-plan-my-skill.md

Validate the plan:

• File exists and is readable
• Contains priority sections (High/Medium/Low)
• Has structured improvement items
• Includes file paths and suggested changes

See references/plan-format.md for detailed plan structure.

Step 2: Parse and Group Changes

Extract all improvement suggestions and organize by target file.

Extract from each item:

• File path (e.g., SKILL.md:line:line or references/file.md)
• Dimension (Description Quality, Content Organization, etc.)
• Impact (+X points)
• Current content
• Suggested content
• Reason for change

Build update queue:

by_file = {
  "SKILL.md": [change1, change2, ...],
  "references/guide.md": [change3, ...],
  "examples/demo.md": [change4, ...],
}