skill-improve

Improves Codex skills through a test-fix-retest loop with static validation and rollback.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Skill authors often change instructions based on preference rather than evidence, breaking routing or behavior without noticing. This Skill enforces an evidence-driven improvement cycle: baseline testing, targeted diagnosis, minimal patching, and re-validation with keep-or-revert decisions based on score changes. ## Core Features & Use Cases - Baseline Testing: Runs the companion skill-test workflow first and records failures before any edit 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 user 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 Ask Codex to improve a specific skill using the test-fix-retest loop and report the diff, validation evidence, and rollback command.

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 Codex skill without breaking it?

Run the skill-test baseline first, diagnose each failure by category, 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.

What kinds of skill failures can be diagnosed?

Failures are classified as routing ambiguity, missing workflow detail, unsafe mutation, broken reference, unsupported metadata, platform coupling, excessive context, or unverifiable output. Each diagnosis drives a targeted minimal fix rather than a broad rewrite.

Does skill improvement change the skill name or trigger?

No. The public name and intended trigger are preserved unless the user explicitly approves a breaking change. Frontmatter is kept to only name and description fields.

What happens if a skill change makes test results worse?

The change is reverted. The workflow compares post-patch validation results against the recorded baseline and keeps the patch only when scores improve, returning a one-command rollback either way.

Does this workflow 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 on Windows. It inherits the active model and permission mode without weakening sandbox boundaries.