skill-improve

Automate iterative skill improvement through a test-fix-retest loop.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/HechaoYannet/3kingdom-unity --skill skill-improve-hechaoyannet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improve
Source: https://github.com/HechaoYannet/3kingdom-unity/tree/main/.claude/skills/skill-improve
Command: npx skills add https://github.com/HechaoYannet/3kingdom-unity --skill skill-improve-hechaoyannet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate the improvement of a single skill by running a structured test-fix-retest loop that diagnoses gaps, proposes targeted fixes, and revalidates changes.

Core Features & Use Cases

  • Phase-driven improvement: parse arguments, baseline tests, diagnose gaps, propose fixes, and retest.
  • Gap analysis: identify missing frontmatter, insufficient phases, missing verdict keywords, and other static checks.
  • Targeted fixes: generate precise edits to SKILL.md and related docs, then re-validate with tests.
  • Revalidation: compare static/category scores before and after changes and decide on keeping or reverting changes.
  • Reproducible workflow: maintain an audit trail and safety checks for revert if necessary.

Quick Start

Run /skill-improve [skill-name] to start the improvement loop for that 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 skill improvement with a test-fix-retest loop?

To automate skill improvement, run a structured test-fix-retest loop that diagnoses gaps, proposes targeted fixes, and revalidates changes. This evaluates skill structure, frontmatter gaps, and rubric alignment to iteratively apply precise modifications.

What static check failures can be diagnosed during skill gap analysis?

Static check failures diagnosed during gap analysis include missing frontmatter, insufficient phases, and missing verdict keywords. The workflow evaluates skill structure and rubric alignment to identify these specific gaps before proposing targeted fixes.

How do I fix missing frontmatter and rubric alignment issues in a skill?

Fix missing frontmatter and rubric alignment issues by generating precise edits to SKILL.md and related docs. The workflow proposes targeted modifications based on diagnosed gaps and validates the changes with follow-up tests.

Does the skill improvement workflow revert changes if test scores drop?

Yes, the skill improvement workflow compares static and category scores before and after changes. It includes safety checks for revert if test scores drop, maintaining a reproducible workflow with an audit trail to decide on keeping or reverting modifications.

Can I use this automated diagnostic workflow for a single skill at a time?

Yes, you can use this automated diagnostic workflow for a single skill at a time. It parses arguments to baseline tests, diagnose gaps, propose fixes, and retest until scores improve or remain stable for that specific skill.