skill-improve

Improve an existing skill through a test-fix-retest loop with static validation and rollback.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill skill-improve-claretagrapelike32
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improve
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/skill-improve
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill skill-improve-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Skill authors often edit skill instructions based on preference rather than evidence, causing regressions in routing, safety, or output quality. This Skill enforces an evidence-driven improvement cycle: baseline testing, targeted diagnosis, minimal patching, and re-testing with keep-or-revert decisions based on score changes. ## Core Features & Use Cases - Baseline Testing: Runs the skill-test workflow first and records failures before any change is made. - Failure Diagnosis: Classifies each failure as routing ambiguity, missing workflow detail, unsafe mutation, broken reference, unsupported metadata, platform coupling, excessive context, or unverifiable output. - Approval-Gated Patching: Proposes the smallest patch with affected files, behavior changes, regressions, and rollback, then waits for approval before editing. - Use Case: A skill triggers on the wrong prompts. Run this Skill to capture baseline test results, diagnose the routing ambiguity, apply a minimal frontmatter fix, re-run all direct, implicit, near-miss, and negative tests, and keep the change only if scores improve. ## Quick Start Use the skill-improve skill to diagnose and fix the failing tests in my skill, then show me the diff and validation evidence.

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 without breaking its existing behavior?

Run the skill-test workflow first to record baseline failures, then propose the smallest patch and wait for approval before editing. After patching, re-run all direct, implicit, near-miss, and negative tests and keep the change only if scores improve.

How to diagnose why a skill triggers on the wrong prompts?

Classify the failure as routing ambiguity, missing workflow detail, or unsupported metadata using the diagnosis step. Inspect all local references and official authoring constraints before changing any instructions.

What frontmatter fields are allowed in a Codex skill?

Only name and description are preserved in the frontmatter during improvement. The starter prompt stays namespaced and realistic, and implicit invocation is disabled for sensitive setup, install, control, refresh, or destructive workflows.

Does skill-improve work on both Windows and macOS?

Yes, it uses PowerShell syntax on Windows and POSIX syntax on macOS and Linux without requiring a Unix compatibility layer. It inherits the active model and permission mode of the Codex surface.

Can I revert a skill improvement if tests get worse?

Yes, every improvement run returns a one-command rollback alongside the diff summary and validation evidence. Changes are kept or reverted based on score change compared to the recorded baseline.