Skills
.Work. You
Rest

skill-refactoring

Community

Split bloated skill.md into focused references.

Content & Communication#documentation#organization#refactor#best-practices#references#progressive-disclosure#skill-md
Authorbuddyh
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Refactor bloated skill.md files by moving detailed content into references/ while keeping the top-level skill.md concise and discoverable.

Core Features & Use Cases

  • Progressive disclosure: shift detailed content to references/ while preserving navigation from skill.md.
  • Loading strategy: specify when to read each reference file to minimize context for Claude.
  • Maintainability: keep skill.md under 500 lines and preserve original content in references/ for retrieval.

Quick Start

Start by identifying a large skill.md, create a references/ folder, and move non-essential content into focused reference files.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: skill-refactoring
Download link: https://github.com/buddyh/agent-skills/archive/main.zip#skill-refactoring

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.