Skill Progressive Refactor

Use when a SKILL.md is too long or costly to load and needs a safe progressive-disclosure refactor into focused references without changing its contract.

9 stars 3 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill skill-progressive-refactor
Manual install
git clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/skill-progressive-refactor ~/.claude/skills/skill-progressive-refactor

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Skill Progressive Refactor

Use this Skill after a quality audit identifies excessive length, duplicated
detail, or poor progressive disclosure. It changes files only within the
authorized Skill directory, preserves the original revision for rollback, and
must not silently alter the Skill's trigger, safety policy, output contract, or
frontmatter identity.

## Freeze the contract

Read the target `SKILL.md` completely and inventory its content hash, line and
character count, frontmatter, triggers, tools, commands, outputs, stopping
conditions, links, and existing `references/`. Read repository instructions
and native validators. Record the baseline and make a bounded refactor plan;
for this authorized maintenance workflow, proceed without an extra approval
round unless a scope, ownership, or destructive-action ambiguity exists.

Separate content into:

- **core control flow:** triggers, phases, decisions, safety boundaries,
  prerequisites, and output handoff; keep these in `SKILL.md`;
- **on-demand detail:** help, templates, examples, reference tables, domain
  knowledge, long checklists, and explanations; move these to single-purpose
  files under `references/`.

Do not split a sentence so that its guard, exception, or stopping condition is
left behind. Preserve exact names, stable anchors, commands, and cross-links;
never rename a colon-form name or external identifier merely to satisfy a style
preference.

## Perform the smallest safe extraction
Read the full skill on GitHub

Details

Skill name
skill-progressive-refactor
Path
skills/skill-progressive-refactor/SKILL.md
License
MIT
Repo updated
8 September 2026

FAQ

What does the Skill Progressive Refactor skill do?

Use when a SKILL.md is too long or costly to load and needs a safe progressive-disclosure refactor into focused references without changing its contract.

How do I install the Skill Progressive Refactor skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill skill-progressive-refactor. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Skill Progressive Refactor popular?

It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.