skill-improver

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

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill skill-improver-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/skill-improver
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill skill-improver-tamagusko

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, especially when multiple changes touch the same lines. This Skill automates parsing improvement plans, resolving conflicts, backing up originals, and executing the edits safely. ## Core Features & Use Cases - Plan Parsing and Grouping: Reads improvement-plan-{name}.md files, extracts prioritized items (High/Medium/Low), and groups changes by target file. - Conflict Detection and Resolution: Detects overlapping edits, applies priority-based resolution, and flags same-priority conflicts for manual review. - Safe Execution with Backup and Verification: Backs up the skill to ~/.claude/skills/backup/ before editing, then verifies YAML validity, structure, and references afterward, producing an update report. - Use Case: After running skill-quality-reviewer on a skill scoring 67/100, ask to apply the improvement plan and get an updated skill plus a report showing the score improvement. ## Quick Start Apply the improvements from improvement-plan-git-workflow.md to my git-workflow skill.

Frequently Asked Questions about skill-improver

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

FAQPage Schema
How do I apply an improvement plan to a Claude Skill?

Point the skill at the improvement-plan-{name}.md file generated by skill-quality-reviewer. It parses the prioritized items, groups changes by file, backs up the original skill, applies edits in priority order, and generates an update report.

How are conflicting changes to the same lines resolved?

Higher priority changes win over lower priority ones for overlapping line ranges. When two changes share the same priority, the first one is applied and the conflict is flagged for manual review in the update report.

Can I restore a skill if an update goes wrong?

Yes. Before any edits, the backup-skill.sh script copies the entire skill directory to ~/.claude/skills/backup/{skill-name}-{timestamp}/ with a manifest containing restore instructions.

What does the verification step check after updates?

The verify-update.sh script checks that SKILL.md exists, YAML frontmatter is valid, referenced files exist, scripts are executable, word count supports progressive disclosure, and the description follows third-person format.

What format must the improvement plan file follow?

The plan needs High, Medium, and Low priority sections, with each item specifying File (with optional line range), Dimension, Impact, Current content, Suggested content, and a Reason. The full specification is in references/plan-format.md.