refactor-skillslisted

Reviews the markdown and template files changed in the current session and tightens them for agent performance — sharper trigger descriptions, progressive disclosure, imperative voice, one-claim-per-bullet, fewer redundant rules — while preserving every workflow step, constraint, and trigger condition. Use when the user has just edited one or more skill or prompt files (`SKILL.md`, `references/*.md`, `recipes/*.md`, agent templates, slash-command prompts) and wants a tightening pass before committing, or invokes "/refactor-skills", "refactor this skill", "tighten the skill", "polish SKILL.md", "make this skill leaner". Behaviour-preserving only — never use this to add features, expand scope, or remove rules.
usrrname/agent-skills · ★ 0 · AI & Automation · score 59

Install: claude install-skill usrrname/agent-skills

# Refactor Skills — agent performance ↑, behaviour = Tightens the markdown / template / skill files touched in the current session. Every edit must make the file cheaper or clearer for an agent to load and act on, **without changing what the skill does**. ## Inputs - Default: every uncommitted `.md`, `.tmpl`, `.txt`, and `.prompt` file under `.claude/`, `~/.claude/`, `docs/`, or any path the session has been editing. Discover with `git status --porcelain` plus the Edit/Write tool history of the current conversation. - If the user names specific files or a directory, restrict to those. - Skip files outside `.claude/`, `docs/`, or the user-specified scope; this skill is not a general prose editor. ## Agent-performance heuristics Apply in this order. Each is a **no-behaviour-change** edit: 1. **Sharper trigger description.** The frontmatter `description` is the only thing the harness sees when ranking skills. Lead with the capability in 1 sentence; follow with "Use when …" listing concrete phrases the user actually says. Drop hedging ("might be helpful for …") and synonyms that add no discoverability. Keep ≤ 1024 chars. 2. **Progressive disclosure.** `SKILL.md` stays under 100 lines. Anything longer, domain-heavy, or rarely needed → move to `references/<topic>.md` and link from SKILL.md. The agent only loads SKILL.md by default. 3. **Imperative voice.** "Run X" > "You should run X" > "It is recommended to run X". Cut auxiliaries. 4. **Concrete over abstract.** Replace "use