All skills
av avatar

/improve-skill

@b71baeb
by Ivan Charapanauav/skills16 stars
2

Improve an existing agent SKILL.md through one gated cycle: select the target (default this skill), snapshot the committed baseline, diagnose against skill-design-principles plus four rubric dimensions, apply exactly one focused change, and ship only if a different agent than the author PASSes with quoted evidence. Use when the user says "improve this skill", "improve-skill", "iterate on SKILL.md", or "apply skill-design-principles to a skill". Do not use for code slop over a duration (anneal), generic timeboxed work (timeboxed-iterating), graph orchestration (workgraph), metric hill-climb on a codebase (autoresearch), or stripping slop from existing prose (catalog-deslop).

  • 4 files
  • 19.3 KB
  • Updated 2 months ago
  • GitHub

Use this Skill: https://skilld.dev/gh/av/skills/improve-skill

This session only. Nothing lands on disk.

referencesknown-bad.md

≈385 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Known-bad fixtures

The independent-gate judge compares the candidate SKILL.md to each fixture. Match means the same shape, not byte identity and not the same name:. Any match → Verdict: FAIL. Do not invent extra shapes. Do not skip a fixture because the candidate added sentences.

Fixture: stub-happy

---
name: improve-skill
description: Improve agent skills.
---
# Improve Skill
Review the target skill and make it better. Be thorough. Consider clarity
and completeness. Commit your changes when you are happy with them.

Match if: frontmatter plus an intent paragraph; no ordered cycle (select / baseline / diagnose / one-change / independent gate / commit-on-pass); description has no WHEN; the author decides it is better ("when you are happy").

Fixture: numbered-gate-free

---
name: improve-skill
description: Improve a SKILL.md. Use when asked to improve a skill.
---
# Improve Skill
1. Read the skill.
2. Think about improvements.
3. Edit it.
4. Commit.

Match if: numbered steps with no off-tree baseline, no diagnosis lens, no one-change limit, and no independent FAIL path; commit is the last step.

Other shapes (no full fixture)

Shape Match if
triggerless description has no WHEN and no quoted utterances
sibling-collision load-steals duration work / code slop / graphs / metric loops without naming those siblings
placeholder body is TODO or "write the procedure later"
ask-back user must supply the diagnosis or the change

Source: SKILL.md on GitHub

No third-party reports yet.

Signed by skilld at b71baeb. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 2 months ago

README badge

README badge for av/skills/improve-skill