skills.rest
TECH-HY
TECH-HYOFFICIAL
Explore all skills by this author →
GitHub

skill-improver

Iteratively reviews and fixes Claude Code skill quality issues using the skill-reviewer agent.

Updated Mar 22, 2026
Search Tags:#automation#claude code#frontmatter#quality improvement#skill review#skill-reviewer#iterative loop
One-click install
npx skills add https://github.com/TECH-HY/SKILLS --skill skill-improver-tech-hy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/TECH-HY/SKILLS/tree/main/skills/skill-improver
Command: npx skills add https://github.com/TECH-HY/SKILLS --skill skill-improver-tech-hy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Skills often accumulate quality issues like weak trigger descriptions, missing frontmatter fields, or broken file references that prevent Claude from loading or selecting them correctly. This Skill automates the fix-review cycle, repeatedly running the skill-reviewer agent and applying fixes until the skill meets quality standards. ## Core Features & Use Cases - Automated Fix-Review Loop: Runs skill-reviewer, categorizes issues by severity (critical, major, minor), fixes them, and re-reviews until the quality bar is met. - Severity-Based Triage: Critical issues (missing frontmatter, invalid YAML, broken paths) and major issues (weak descriptions, missing sections) are always fixed; minor issues are evaluated for validity before applying. - Explicit Completion Marker: Terminates only when all critical and major issues are resolved, signaled by a strict completion marker. - Use Case: You wrote a new skill and want it polished to project standards. Invoke this Skill to run repeated review-fix cycles instead of manually editing after each review pass. ## Quick Start Ask Claude to improve the skill at your skill's directory path using the skill-improver workflow until all critical and major issues are fixed.

Frequently Asked Questions about skill-improver

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

FAQPage Schema
How do I automatically fix quality issues in a Claude Code skill?▼

Invoke the skill-improver workflow on the skill's directory path. It runs the skill-reviewer agent, categorizes issues by severity, fixes critical and major problems, and repeats the review until the skill passes.

What is the difference between skill-improver and skill-reviewer?▼

skill-reviewer performs a one-time quality assessment and reports issues. skill-improver runs an iterative loop that applies fixes and re-reviews until the skill meets standards. Use skill-reviewer directly for single-pass reviews.

Does skill-improver require any plugins to work?▼

Yes, it requires the plugin-dev plugin, which provides the skill-reviewer agent. Verify it is enabled by running /plugins; if missing, install it from the Trail of Bits plugin repository.

When should I not use skill-improver?▼

Avoid it for one-time reviews, quick single fixes, non-skill files, or experimental skills still under active exploration. It only operates on SKILL.md files and works best for skills with multiple known quality issues.

Why does the skill-improver loop not stop after fixes are applied?▼

The loop only terminates when the explicit <skill-improvement-complete> marker is output. Natural language statements like 'looks good' do not stop it, and the marker must only appear after verifying all critical and major issues are fixed.

Related Skills

Explore More Software Engineering Skills→
manuelbrandner85manuelbrandner85

skill-improver

Automate iterative quality assessment and refinement of SKILL.md files.

Community
Intermediate
Naw3Naw3

claude-code-plugins

Build Claude Code plugins with commands, agents, hooks, and MCP servers.

Community
Intermediate
farzanmrzfarzanmrz
6

skill-improver

Automate iterative fix-review cycles for Claude Code skills using the skill-reviewer agent.

Community
Advanced
MomoDavilukeMomoDaviluke
2

write-a-skill

Create SKILL.md files with standardized frontmatter and core instructions.

Community
Intermediate