skill-improve

Run a test-fix-retest loop to improve SKILL.md static and category scores.

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/imgamer/AILearn --skill skill-improve-imgamer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improve
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/skill-improve
Command: npx skills add https://github.com/imgamer/AILearn --skill skill-improve-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improves a targeted skill by running a test-fix-retest loop so static and category scores improve instead of drifting with guesswork.

Core Features & Use Cases

  • Baseline scoring first: Runs static checks (and category rubric checks when a category is assigned) to establish a measurable starting score.
  • Targeted diagnostics: Identifies the exact gaps tied to failing/warning checks, then proposes fixes only for what is failing.
  • Safer iteration with re-test: Writes the improved version, re-runs tests, and keeps or suggests revert based on combined score change for rapid quality gains.
  • Use Case: When you notice a skill failing specific checks (e.g., missing ask-before-write language or weak follow-up structure), use this workflow to systematically repair it and verify improvement.

Quick Start

Ask the system to improve a specific skill by running: /skill-improve tech-debt

Frequently Asked Questions about skill-improve

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

FAQPage Schema
How do I improve a skill's markdown quality using static checks?

You improve skill markdown by running a baseline static check, diagnosing failing check gaps, proposing minimal before/after edits, and verifying gains through a re-test loop.

What is a test-fix-retest loop for skill improvement?

A test-fix-retest loop for skill improvement runs static and category rubric tests, applies targeted minimal edits to the SKILL.md file, and retains changes only if the combined score increases upon re-testing.

How do I fix failing category rubric checks in a skill?

Fix failing category rubric checks by identifying exact diagnostic gaps tied to warnings, proposing minimal before/after markdown edits to address those gaps, and verifying the fix through score-based re-testing.

Does skill improvement work on single-skill iterations only?

Yes, skill improvement applies to targeted, single-skill iterations, focusing on diagnosing specific failing static checks and category rubrics to systematically repair one skill at a time.

How do I establish a baseline score before editing skill markdown?

Establish a baseline score by running static checks and optional category rubric checks against the current skill markdown, generating a measurable starting score for tracking iterative improvements.

What happens if a proposed markdown edit lowers the skill score?

If an edit lowers the combined score during the re-test phase, the system suggests a revert to the previous version, ensuring only score-improving changes are kept in the final SKILL.md.