skill-improve

Run a test-fix-retest loop on SKILL.md files with diagnostics and git rollback.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill skill-improve-polsegu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improve
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/skill-improve
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill skill-improve-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the tedious manual process of improving individual Skill units by running diagnostics, proposing targeted fixes, applying edits, and verifying results so maintainers don't have to iterate by hand.

Core Features & Use Cases

  • Baseline testing: Runs static checks and optional category checks to record failures and warnings as a baseline.
  • Targeted diagnosis and fixes: Identifies exact gaps for failing checks and proposes minimal, focused edits with before/after diff previews.
  • Safe write and rollback: Writes improvements, re-runs tests to compare scores, and optionally reverts changes via git if the combined score does not improve.
  • Use Case: Use this Skill to continuously improve SKILL.md files across the studio, ensuring consistent quality and test coverage for automation workflows.

Quick Start

Run /skill-improve [skill-name] to test, propose, write, and retest a single skill's SKILL.md.

Frequently Asked Questions about skill-improve

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

FAQPage Schema
How do I automate iterative improvements for SKILL.md files?

You can automate iterative SKILL.md improvements by running a test-fix-retest loop that applies static diagnostics, proposes targeted edits, and verifies results. This skill executes that cycle automatically to eliminate manual maintenance overhead for individual skill directories.

Can I roll back SKILL.md changes if test scores do not improve?

Yes, you can roll back SKILL.md changes if test scores do not improve thanks to git integration. The skill writes edits, re-runs tests to compare combined scores against the baseline, and optionally reverts changes via git when the updated score does not show an improvement.

What static analysis checks are run during skill testing diagnostics?

Static analysis checks run during skill testing diagnostics include baseline testing for individual .claude/skills directories using the CCGS testing catalog. The skill records failures and warnings from static checks and optional category checks to identify exact gaps and propose focused diff previews.

Do I need git installed to use automated skill testing and improvement loops?

You do not strictly need git installed to run automated skill improvement loops, but it is required for optional rollback functionality. The core skill requires access to skill-test commands, read/write access to SKILL.md, and the CCGS testing catalog to perform diagnostics and verification cycles.

What's the best way to fix failing static checks in a skill directory?

The best way to fix failing static checks is to run targeted diagnosis that identifies exact gaps and proposes minimal, focused edits. This skill automates that process by generating before/after diff previews, applying safe writes, and retesting to verify score improvements against the baseline.