skills.rest
Clay-HHK
Clay-HHKCOMMUNITY
Explore all skills by this author →
GitHub

skill-improver

Applies improvement plans from quality reviews to update Claude Skill files.

1|Updated Mar 5, 2026
Search Tags:#automation#markdown#claude skills#backup#skill improvement#conflict resolution#quality review
One-click install
npx skills add https://github.com/Clay-HHK/claude-skills --skill skill-improver-clay-hhk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/Clay-HHK/claude-skills/tree/main/skill-improver
Command: npx skills add https://github.com/Clay-HHK/claude-skills --skill skill-improver-clay-hhk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Manually applying dozens of suggestions from a skill quality review report is tedious and error-prone. This Skill automates the execution of improvement plans, handling parsing, conflict resolution, backups, and verification so skill updates are applied consistently and safely. ## Core Features & Use Cases - Plan Parsing and Grouping: Reads improvement-plan-{name}.md files generated by skill-quality-reviewer, extracts improvement items, and groups changes by target file. - Conflict Detection and Priority Merging: Resolves overlapping edits using priority-based rules (High → Medium → Low) and flags same-priority conflicts for manual review. - Backup and Verification: Creates timestamped backups via backup-skill.sh and validates YAML frontmatter, file structure, and writing style via verify-update.sh after updates. - Use Case: After running a quality review on your git-workflow skill that scored 67/100, ask to apply the improvement plan and receive an updated skill plus an update report showing the score improvement to 87/100. ## Quick Start Apply the improvements from improvement-plan-git-workflow.md to my git-workflow skill and generate an update report.

Frequently Asked Questions about skill-improver

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

FAQPage Schema
How do I apply improvements from a skill quality review report?▼

Provide the improvement-plan-{skill-name}.md file generated by skill-quality-reviewer and ask to apply it. The skill parses all improvement items, groups them by file, resolves conflicts by priority, backs up the original, applies edits, and generates an update report.

What is the improvement plan file format for skill updates?▼

The plan is a Markdown file with High, Medium, and Low priority sections. Each item specifies a File path with optional line numbers, Dimension, Impact in points, Current content, Suggested content, and a Reason for the change.

Does skill-improver work with skill-quality-reviewer?▼

Yes, it is designed to consume improvement-plan files produced by skill-quality-reviewer. The typical loop is: review a skill, apply the improvement plan, then re-review to validate the quality score improvement.

What happens when two improvements conflict on the same lines?▼

The higher priority change wins and the lower priority change is skipped. If both have the same priority, the first change is applied and the conflict is flagged for manual review in the update report.

Can I restore my skill if an update breaks it?▼

Yes, every run creates a timestamped backup under ~/.claude/skills/backup/ before applying changes. The backup includes a manifest with restore instructions, so you can copy the files back to recover the original state.

Related Skills

Explore More Software Engineering Skills→
Galaxy-DawnGalaxy-Dawn
5.3k

skill-quality-reviewer

Evaluates Claude Skills across description, organization, style, and structure to generate weighted quality reports.

Community
Intermediate
Clay-HHKClay-HHK
1

skill-quality-reviewer

Evaluates Claude Skills across description, organization, style, and structure to generate scored quality reports.

Community
Intermediate
chemistrywow31chemistrywow31
54

MD Generation Standard

Standardize markdown documentation for agents, skills, and rules in Codex.

Community
Basic
EveryIncEveryInc
24.7k

ce-skill-work

Applies a skill-authoring standard to create, edit, review, and respond to feedback on SKILL.md files.

Official
Advanced