skill-auto-improver

Automate iterative SKILL.md improvements to pass Gate 1 and asm-eval 85/8 standards.

787|71|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/luongnv89/asm --skill skill-auto-improver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-auto-improver
Source: https://github.com/luongnv89/asm/tree/main/skills/skill-auto-improver
Command: npx skills add https://github.com/luongnv89/asm --skill skill-auto-improver

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Skill Auto-Improver orchestrates an automated, two-gate improvement loop to retrofit an existing SKILL.md so it meets the skill-creator standard (Gate 1) and the asm-eval 85/8 quality floor (Gate 2).

Core Features & Use Cases

  • Deterministic fixes via asm eval --fix to clean up mechanical issues and normalize frontmatter.
  • Frontmatter migration moving top-level author/version fields into metadata to satisfy quick_validate.py.
  • Phase-driven workflow: Gate 1 retrofit followed by targeted Gate 2 category fixes, with per-iteration version bumps and a final report.
  • Use cases include preparing skills for publish, improving catalog readiness, and dogfooding quality improvements on internal skills.

Quick Start

Run the Skill Auto-Improver against a local skill directory to begin the two-gate improvement loop.

Frequently Asked Questions about skill-auto-improver

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

FAQPage Schema
How do I automate SKILL.md improvements to pass quality validation gates?

You can automate SKILL.md improvements by running a phase-driven loop that applies deterministic fixes and frontmatter normalization. This process retrofits existing local files to meet the skill-creator Gate 1 standard and the asm-eval 85/8 quality floor.

What is the asm-eval 85/8 floor for skill quality?

The asm-eval 85/8 floor is a required quality threshold that SKILL.md files must pass during automated improvement. It represents a scoring baseline evaluated by the asm tool to ensure skills meet catalog readiness before publishing.

Do I need Python and the asm tool installed to normalize frontmatter in SKILL.md?

Yes, normalizing frontmatter and running the improvement loop requires Python 3, the asm tool on PATH, and the skill-creator validator. These dependencies are necessary to execute the deterministic fixes and validation checks.

How do I migrate top-level author and version fields in SKILL.md frontmatter?

Migrating top-level author and version fields involves moving them into the metadata block to satisfy quick_validate.py. The auto-improver handles this automatically during the Gate 1 phase to normalize the overall frontmatter structure.

What happens when a SKILL.md file fails both Gate 1 and Gate 2 validation?

When validation fails, the automation applies targeted per-category edits and version bumps iteratively. If a blocker prevents passing both gates, the loop stops and emits a final report describing the unresolved issues and changes.

Does the automated skill improvement process generate version management artifacts?

Yes, the process generates .asm-improver artifacts and a final report. These outputs document the applied deterministic changes, per-iteration version bumps, and the overall improvement status for the retrofitted SKILL.md.