skill-improve

Improve skills via test-fix-retest loops with static and category checks.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill skill-improve-imclab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improve
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/skill-improve
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill skill-improve-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reduces the guesswork in improving an existing skill by measuring failures and warnings, diagnosing the exact gaps, applying targeted edits, and verifying improvement with re-tests.

Core Features & Use Cases

  • Test → fix → retest loop: Runs static and optional category rubric checks, then keeps or reverts changes based on score improvement.
  • Targeted diagnosis: Identifies which static check failed (or warned) and maps failures to concrete frontmatter/body gaps.
  • Controlled writing: Shows before/after proposals and asks for permission before modifying the skill file.
  • Use Case: When a skill under .claude/skills/ fails required quality gates, run this Skill to upgrade it until it passes static and category standards.

Quick Start

Run /skill-improve skill-improve to improve that skill by running baseline checks, proposing targeted fixes, and re-testing after applying them.

Frequently Asked Questions about skill-improve

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

FAQPage Schema
How do I fix failing static analysis checks on my skill files?

Run a test-fix-retest workflow to reduce static analysis failures and warnings by measuring baseline counts, diagnosing exact gaps tied to specific check IDs, and applying targeted edits to frontmatter and body instructions until warnings are resolved.

What is a test-fix-retest loop for skill quality remediation?

A test-fix-retest loop for skill quality remediation runs static and category rubric checks, proposes minimal before/after edits with confirmation, and keeps or reverts changes based on whether the combined validation score improves.

How do I improve code quality and reduce warnings in skill frontmatter?

Improve code quality and reduce warnings in skill frontmatter by running baseline static checks, mapping failures to concrete frontmatter gaps, proposing minimal edits, and validating the updated file using static and category tests.

Can I revert skill edits if the retest score does not improve?

Yes, you can revert skill edits if the retest score does not improve, because the workflow automatically reverts changes when the combined score from the static and category rubric checks fails to show measurable improvement.

Does skill improvement automation require manual confirmation before writing changes?

Yes, skill improvement automation requires manual confirmation before writing changes, because the workflow shows before/after proposals for targeted edits and asks for permission before modifying the skill file.

What's the best way to automate quality gate checks for skills in .claude/skills/?

The best way to automate quality gate checks for skills in .claude/skills/ is running a measurable test-fix-retest workflow that executes static and optional category rubric checks, diagnoses failures, and validates improvements until the skill passes documented gates.