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.