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.
Install
npx skills add sandbaseai/workbuddy-skill --skill skill-progressive-refactorgit 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-refactorPersonal 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
Details
- Skill name
skill-progressive-refactor- Repository
- sandbaseai/workbuddy-skill
- 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
Access Control Security Best Practices
9sandbaseai/workbuddy-skill
Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.
Accessibility Review
9sandbaseai/workbuddy-skill
Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.
Acquire Codebase Knowledge
9sandbaseai/workbuddy-skill
Use when the user asks to map, document, or onboard into an existing codebase and needs evidence-backed architecture, structure, conventions, integrations, testing, and concerns documentation.
Source Driven Development
9sandbaseai/workbuddy-skill
Use when implementing framework- or library-specific behavior where current official documentation, version compatibility, and source citations matter more than memory or generic examples.
Silent Failure Hunter
5euxx/claude-skills-for-copilot
Audits error handling for silent failures, inadequate user feedback, and unjustified fallback behavior. Finds issues in catch blocks, fallbacks, and error paths. Use after modifying error handling code.
Systematic Debugging
9sandbaseai/workbuddy-skill
Use when encountering a bug, test failure, performance regression, build failure, integration issue, or unexpected behavior before proposing or applying a fix.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.