skill-improve

Run a test-fix-retest loop on skills in the .Codex/skills directory.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill skill-improve-carlosq96
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improve
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.agents/skills/skill-improve
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill skill-improve-carlosq96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintaining high‑quality skill definitions is time‑consuming because developers must manually run static and category checks, identify failures, and edit the skill files. This Skill automates that iterative process, turning a tedious test‑fix‑retest cycle into a single command.

Core Features & Use Cases

  • Automated Baseline Testing: Runs static and optional category tests to capture current failure counts.
  • Targeted Diagnosis: Analyzes each failing check and explains the exact gap in the skill definition.
  • Selective Fix Application: Proposes precise edits, asks for user confirmation, applies changes, and retests to verify improvement.
  • Safe Reversion: Restores the original skill file if the new version does not improve the combined score.

Quick Start

Run /skill-improve my-skill to automatically test, fix, and validate the skill.

Frequently Asked Questions about skill-improve

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

FAQPage Schema
How do I automate static analysis checks for skill files?

Automated baseline testing runs static and optional category checks to capture current failure counts, then analyzes each failing check to explain the exact gap in the skill definition before proposing fixes.

How do I run a test-fix-retest loop to fix failing skill checks?

Run the test-fix-retest loop by executing a single command targeting your skill directory; the tool proposes precise edits, asks for user confirmation, applies changes, and retests to verify improvement.

Can I use Bash tools to read and write skill files for automated testing?

Bash tools are optionally used to read and write skill files during improvement. The process requires executing test commands and modifies files in the .Codex/skills directory to apply targeted fixes.

What happens if automated edits do not improve the combined test score?

If new edits do not improve the combined score, safe reversion automatically restores the original skill file, ensuring your skill definition is never degraded by a failed automated fix attempt.

Do I need existing skills in the .Codex/skills directory to use automated improvement?

Yes, automated improvement applies to any existing skill in the .Codex/skills directory, targeting static and category checks to iteratively improve the skill definition's quality.