skill-improver

Apply prioritized improvement plans to Claude Skills and generate update reports.

2|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Clay-HHK/claude-config --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-config/tree/main/skills/skill-improver
Command: npx skills add https://github.com/Clay-HHK/claude-config --skill skill-improver-clay-hhk

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill automates applying structured improvement plans to Claude Skills so maintainers can reliably implement quality-review recommendations, resolve conflicting edits, and verify that updates preserve skill integrity.

Core Features & Use Cases

  • Parse improvement-plan-{skill-name}.md files and extract prioritized improvement items with file targets and suggested content.
  • Group changes by file, detect and resolve conflicts using priority rules, back up originals, execute edits or create new files, and run verification checks.
  • Generate a detailed update report documenting applied changes, skipped items, conflicts, verification results, and backup locations.
  • Use cases: apply improvements produced by skill-quality-reviewer, update documentation and examples, fix YAML frontmatter and writing-style issues, and perform safe bulk edits across skill repositories.

Quick Start

Apply the improvement plan improvement-plan-git-workflow.md to the git-workflow skill and produce 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 automatically apply an improvement plan to update markdown documentation and scripts?

To automatically apply an improvement plan, use a skill-improver to parse improvement-plan markdown files, group prioritized changes by file, and coordinate edits across SKILL.md, references, scripts, and examples. It backs up originals, executes edits, and generates a detailed update report.

What is the best way to resolve conflicting edits when bulk updating skill repositories?

Resolving conflicting edits during bulk updates is handled by parsing YAML frontmatter and code blocks, then applying priority rules to group changes by file. The process detects conflicts, backs up files, performs safe edits, and validates YAML and file integrity.

Do I need yq installed to parse YAML frontmatter and validate file integrity?

Yes, you need yq installed as a dependency to parse YAML frontmatter and validate file integrity. The skill-improver relies on yq to process improvement-plan files and ensure updates preserve skill structure during maintenance workflows.

How does applying a quality-review improvement plan preserve skill integrity?

Applying a quality-review improvement plan preserves skill integrity by backing up original files before executing edits, validating YAML structure, and running verification checks. It generates an update report documenting applied changes, skipped items, and backup locations.

Can I use this to fix YAML frontmatter and writing-style issues across multiple skill files?

Yes, you can use it to fix YAML frontmatter and writing-style issues across multiple skill files. It groups changes by file targets, creates new files if needed, and performs safe bulk edits while generating a detailed update report.

Why are some improvement items skipped during automated skill maintenance?

Improvement items are skipped during automated skill maintenance when conflicts cannot be resolved by priority rules or verification checks fail. The generated update report documents these skipped items, conflicts, and backup locations for manual review.