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.

referencesrestore.md

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

FAIL restore

Step 6 FAIL only. Reuse $d, $skill_dir, and $repo from step 2. Stop if $d/baseline/SKILL.md is missing — do not invent a restore.

The live tree may have paths the baseline does not (assets/, extra root files, new files under references/). Overlay the baseline, then delete those extras so they cannot leak.

if [ ! -f "$d/baseline/SKILL.md" ]; then
  echo "missing $d/baseline/SKILL.md; stop; do not invent a restore"
  exit 1
fi
cp -R "$d/baseline/." "$skill_dir/"
find "$skill_dir" -mindepth 1 \( -type f -o -type d \) | sort -r | while IFS= read -r p; do
  rel="${p#"$skill_dir"/}"
  if [ ! -e "$d/baseline/$rel" ]; then
    rm -rf "$p"
  fi
done

Do not git commit. After this script, step 6 still runs generate.ts when $repo/scripts/generate.ts exists.

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