skill-improve

Improve OpenCode skills by running a test-fix-retest loop on SKILL.md files.

72|7|Updated Apr 29, 2026

Search Tags:#workflow automation #skill improvement #SKILL.md #static checks #git revert #test-retest loop

Ready to run

npx skills add https://github.com/striderZA/OpenCodeGameStudios --skill skill-improve-striderza

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-improve
Source: https://github.com/striderZA/OpenCodeGameStudios/tree/main/.opencode/skills/skill-improve
Command: npx skills add https://github.com/striderZA/OpenCodeGameStudios --skill skill-improve-striderza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you reduce a skill’s failing and warning checks by running a structured improvement loop and only keeping changes that improve the overall score.

Core Features & Use Cases

Test-fix-retest loop: Runs static tests, proposes targeted fixes, rewrites the skill, and then re-runs tests to confirm improvement.
Guided diagnosis: Detects specific gaps in required frontmatter and body conventions (and optionally category rubric gaps).
Safe change control: Asks for approval before writing, and offers an easy revert if the score doesn’t improve.

Use Case: If a skill fails checks like “no ask-before-write language” or lacks required verdict keywords, you can identify exactly what’s missing, patch only those parts, and verify the improvement via re-testing.

Quick Start

Run /skill-improve tech-debt to improve the specified skill by applying only test-verified fixes and retaining the version if the score improves.

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 checks in a SKILL.md file?▼

To fix failing static checks in a SKILL.md file, use a deterministic test-fix-retest loop that identifies specific frontmatter and body convention failures, proposes targeted fixes, and verifies the improvement through re-testing. Only changes that improve the overall validation score are kept.

What is a test-retest loop for skill improvement?▼

A test-retest loop for skill improvement is an automated workflow that runs static validation checks on a skill file, applies targeted patches to failing sections, and then re-runs the tests to confirm the overall score has improved before permanently keeping the changes.

How do I automatically revert skill file changes if validation scores drop?▼

You can automatically revert skill file changes if validation scores drop by running an improvement loop that compares combined test scores before and after writing patches. If the score does not improve, the workflow executes a git revert to safely restore the previous version.

Can I automate workflow checks for missing required verdict keywords in skill files?▼

Yes, you can automate workflow checks for missing required verdict keywords in skill files by running guided diagnostics that detect specific gaps in required body conventions. The workflow then patches only those missing parts and verifies the fix through automated re-testing.

Does the skill improvement process require approval before writing changes?▼

Yes, the skill improvement process requires explicit approval before writing changes to your SKILL.md file. This safe change control mechanism ensures you review targeted fixes, while offering an easy git revert if the re-test score does not improve.