Skills

Skill Improve

Improve a skill via a test-fix-retest loop, static checks, targeted fixes, keep or...

Install

npx skills add Donchitos/Claude-Code-Game-Studios --skill skill-improve -g -a claude-code -y
Category
Testing
Updated
17d ago
License
MIT
Context cost
Mediumabout 1,736 tokens
Runs scripts
No, instructions only

What it does

Improve a skill via a test-fix-retest loop, static checks, targeted fixes, keep or revert on score change.

!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys automation

Automation mode: Resolve modes.automation (project.local.yaml → project.yaml → default collaborative). Every AskUserQuestion call and every file write follows .claude/docs/automation-modes.md (collaborative asks always · guided major-only · autonomous logs and proceeds; automation_always_ask categories always prompt).

Skill Improve

Runs an improvement loop on a single skill: test → fix → retest → keep or revert.

Its score comes from /skill-test static and category checks, which read the skill rather than run it: a better score means a better-written skill, not proof that it behaves better. To check behaviour, run the skill on a real request before and after the change.


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."

Glob CCGS Skill Testing Framework/catalog.yaml. When it exists, say so first: "CCGS Skill Testing Framework/ was renamed studio-tests/ in 1.2.0, and this skill reads only studio-tests/. Move any specs you wrote there; UPGRADING.md (v1.1.3 → v1.2.0, studio-tests/) says how." Then go on.


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 the static result is NOT ASSESSED (the skill file could not be read or parsed), stop and report it with its reason: there is no score to improve, and 0 FAILs from a file nobody could read is not a clean result.

If baseline is 0 FAILs and 0 WARNs, note it and proceed to Phase 2b.

Read the whole SKILL.md on GitHub

More in Testing