skill-improve

Solid

Improve a skill using a test-fix-retest loop. Runs static checks, proposes targeted fixes, rewrites the skill, re-tests, and keeps or reverts based on score change.

AI & Automation 20,436 stars 2970 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 97/100

Stars 20%
100
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Skill Improve Runs an improvement loop on a single skill: test → fix → retest → keep or revert. --- ## Phase 1: Parse Argument Read the skill name from the first argument. If missing, output usage and stop: ``` Usage: /skill-improve [skill-name] Example: /skill-improve tech-debt ``` Verify `.claude/skills/[name]/SKILL.md` exists. If not, stop with: "Skill '[name]' not found." --- ## Phase 2: Baseline Test Run `/skill-test static [name]` and record the baseline score: - Count of FAILs - Count of WARNs - Which specific checks failed (Check 1–7) Display to the user: ``` Static baseline: [N] failures, [M] warnings Failing: Check 4 (no ask-before-write), Check 5 (no handoff) ``` If baseline is 0 FAILs and 0 WARNs, note it and proceed to Phase 2b. ### Phase 2b: Category Baseline Look up the skill's `category:` field in `CCGS Skill Testing Framework/catalog.yaml`. If no `category:` field is found, display: "Category: not yet assigned — skipping category checks." and skip to Phase 3. If category is found, run `/skill-test category [name]` and record the category baseline: - Count of FAILs - Count of WARNs - Which specific category rubric metrics failed Display to the user: ``` Category baseline: [N] failures, [M] warnings ([category] rubric) ``` If BOTH static and category baselines are 0 FAILs and 0 WARNs, stop: "This skill already passes all static and category checks. No improvements needed." --- ## Phase 3: Diagnose Read the full skill file at `.claude/sk...

Details

Author
Donchitos
Repository
Donchitos/Claude-Code-Game-Studios
Created
3 months ago
Last Updated
1 weeks ago
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

skill-improver

Autoresearch loop for Claude Code skills — greedy keep/discard hill climbing on a 10-dimension quality rubric, with blind subagent validation for self-scoring bias, plus a `freshen` mode that probes external references (release notes, docs, deprecation signals) and applies verified updates, plus a `trigger` mode that measures and tunes the skill's frontmatter description until it reliably fires when it should and stays silent when it shouldn't (60/40 train/test split, 3 runs/query, blinded test scores).

3 Updated today
air-gapped
Testing & QA Solid

skill-test

Validate skill files for structural compliance and behavioral correctness. Three modes: static (linter), spec (behavioral), audit (coverage report).

20,436 Updated 1 weeks ago
Donchitos
AI & Automation Solid

skill-improver

Iteratively improve a Claude Code skill using the skill-reviewer agent until it meets quality standards. Use when improving a skill with multiple quality issues, iterating on a new skill until it meets standards, or automated fix-review cycles instead of manual editing.

39,227 Updated today
sickn33
AI & Automation Listed

skill-optimizer

Evaluate and improve an existing Claude Code skill using explicit success criteria and small controlled changes. Use when the user asks to optimize a skill, reduce over-triggering or under-triggering, improve reliability, tighten instructions, or add evals for a skill. Also trigger on "スキルを改善して", "スキルを最適化して", "スキルの品質を確認して".

2 Updated today
s977043
AI & Automation Solid

skill-improver

Iteratively reviews and fixes Claude Code skill quality issues until they meet standards. Runs automated fix-review cycles using the skill-reviewer agent. Use to fix skill quality issues, improve skill descriptions, run automated skill review loops, or iteratively refine a skill. Triggers on 'fix my skill', 'improve skill quality', 'skill improvement loop'. NOT for one-time reviews—use /skill-reviewer directly.

5,487 Updated 3 days ago
trailofbits