refactor-skill

Featured

Use when about to refactor or refine an existing skill, its SKILL.md or sibling files, from a full restructure down to a one-line wording fix; a change that looks too small to need this skill is not an exemption. Not for creating a skill from scratch or for fixing only its allowed-tools

Code & Development 138 stars 25 forks Updated today MIT

Install

View on GitHub

Quality Score: 93/100

Stars 20%
71
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Overview Refactor a skill. A skill spends two budgets. Its description is loaded into every session, so each word there must do triggering work. Its body enters the context on invocation and stays there for the rest of the session, so each line there must be a step the agent performs or reference every path through the skill needs. Everything else moves behind a pointer or out of the skill. ## Instructions 1. **Pick the target.** If the invocation names one, resolve it to its `SKILL.md`. Otherwise ask which skill. Read `SKILL.md` and every sibling file in its directory. If the invocation also names a change to make, that change sets the scope: the verdicts below cover the lines it adds or touches, the rest of the skill stays as it is, and anything noticed there is a follow-up. 2. **Fetch the guides.** Fetch these pages. They calibrate the delete, demote, and rewrite verdicts below: - https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices - https://code.claude.com/docs/en/skills#frontmatter-reference and https://code.claude.com/docs/en/skills#skill-content-lifecycle - https://raw.githubusercontent.com/mattpocock/skills/main/skills/productivity/writing-for-agents/SKILL.md - https://raw.githubusercontent.com/mattpocock/skills/main/skills/productivity/writing-for-agents/SKILL-MECHANICS.md - The page for the model the skill targets: its `model:` frontmatter when set, otherwise the most capable model: - No `model:` or Fable 5.1: h...

Details

Author
vinta
Repository
vinta/hal-9000
Created
10 years ago
Last Updated
today
Language
Python
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

refactor-skills

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.

0 Updated 1 weeks ago
usrrname
AI & Automation Listed

rc-skill-best-practices

Author, refactor, and debug agent skills. Use when creating a new skill from scratch, pruning or restructuring a bloated SKILL.md, tightening a skill description's triggers, or diagnosing bundled references the agent ignores. Do not use for agent instruction files like CLAUDE.md or AGENTS.md (rc-agents-md), for measuring what the whole config surface costs in tokens (rc-context-budget), or for general documentation and READMEs (rc-readme).

19 Updated 1 months ago
rodolfochicone
Code & Development Listed

refactoring

Use when refactoring code, or when an in-scope readability or design problem obstructs requested work. Improve code form without changing behavior.

0 Updated 1 weeks ago
jonfazzaro