← All skills

improve-skill

82 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By av/skills (GitHub) · coding · 28 stars · scanned at commit 8f70341

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),…

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'improve-skill' ] || [ -L ~/.agents/skills/'improve-skill' ]; then echo 'A skill folder named improve-skill already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/av/skills' "$d" && git -C "$d" checkout --quiet '8f70341629e3871b17c34b54aca27e02bf1d4b49' -- 'improve-skill' && mkdir -p ~/.agents/skills && cp -R "$d"/'improve-skill' ~/.agents/skills/'improve-skill' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'improve-skill' ~/.claude/skills/'improve-skill' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for av/skills shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/av/skills.svg)](https://zalavijaysinh.github.io/skilltrust/repos/av/skills/)

Score history