skill-improver

Automates iterative improvement of Claude Code skills via a scoring and mutation loop.

5|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/air-gapped/skills --skill skill-improver-air-gapped
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/air-gapped/skills/tree/main/.claude/skills/skill-improver
Command: npx skills add https://github.com/air-gapped/skills --skill skill-improver-air-gapped

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Automates the iterative improvement of Claude Code skills by running an autoresearch loop that scores, hypothesizes, mutates, and re-evaluates skill documentation to raise overall quality.

Core Features & Use Cases

  • Automates scoring across 10 dimensions, generates improvement hypotheses, and applies a single atomic change per iteration.
  • Supports multiple modes (improve, score, freshen, trigger, philosophy, batch) and batch workflows for many skills.
  • Records changes in a backlog and performs blind validation to reduce bias.

Quick Start

Run the autoresearch loop against a target skill by invoking the improve mode with the target skill name.

Frequently Asked Questions about skill-improver

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

FAQPage Schema
How do I automate iterative improvement of Claude Code skills?

Automating iterative skill improvement uses a greedy hill-climbing autoresearch loop that scores, hypothesizes, mutates, and re-evaluates SKILL.md files to raise overall quality across multiple dimensions.

What is blind validation in an autoresearch loop for skill optimization?

Blind validation in an autoresearch loop reduces scoring bias by re-evaluating mutated skill documentation without prior context, ensuring objective quality checks before persisting changes to the backlog.

How do I score Claude Code skills against a rubric?

Scoring Claude Code skills against a rubric involves evaluating SKILL.md frontmatter and content across 10 dimensions, generating improvement hypotheses, and applying atomic changes per iteration.

Can I run batch workflows to improve multiple skill directories at once?

Batch workflows support improving multiple skill directories at once by using batch-mode orchestration to apply the autoresearch loop across many skills sequentially within the .claude/skills structure.

Do I need local skill directories to use the skill-improver autoresearch loop?

Yes, you need local skill directories under .claude/skills along with the references and scripts structure, as the autoresearch loop requires direct file access to perform scoring, mutations, and backlog updates.

What modes are available for optimizing Claude Code skill documentation?

Available modes for optimizing Claude Code skill documentation include improve, score, freshen, trigger, philosophy, and batch, each targeting specific aspects of the autoresearch and quality enhancement workflow.