How does the skill ensure no content is lost during the split?

It uses a Phase 4 Validation step that includes a coverage matrix, ensuring every original section is accounted for in the new structure before the process is finalized.

Does it handle external reference files and documentation?

Yes. It migrates relevant files in the references/ subdirectory to their new respective skill locations and updates all relative links and back-links automatically.

Will refactoring break my existing command workflows?

No. The Refactor Skill automatically converts the original monolithic skill into a facade (meta-skill) that loads the new specialists, ensuring all existing references continue to function.

When should I refactor a Claude Code skill?

You should consider refactoring when a skill exceeds 500 lines, covers multiple distinct expertise domains, or requires significantly different tool sets for different sections.

What are the primary benefits of smaller, modular skills?

Modular skills reduce context noise for the LLM, improve invocation precision, allow for targeted testing, and enable easier reuse of specific logic across different plugins.

Claude Skill Refactorer

Name: Claude Skill Refactorer
Author: Jamie-BitFlight

byJamie-BitFlight

•

開発者ツール

Decomposes monolithic or oversized Claude Code skills into modular, purpose-built specialist skills while maintaining full functional parity.

The Refactor Skill is a meta-development tool designed to optimize the performance and maintainability of Claude Code environments. It identifies logical boundaries within high-complexity skills—specifically those exceeding 500 lines or spanning multiple domains—and automates the process of splitting them into independent components. By generating a comprehensive refactoring plan, migrating reference files, and creating a backwards-compatible facade, it ensures that your AI workflows remain organized, efficient, and easy to extend without breaking existing command structures.

主な機能

01Mandatory facade creation to ensure zero disruption to existing workflows

02Intelligent cross-referencing and internal link migration

03Automated generation of new SKILL.md files and directory structures

04Automated domain analysis and dependency mapping for complex skills

0518 GitHub stars

06Structured refactoring plans with fidelity checklists and coverage matrices

ユースケース

01Cleaning up technical debt in growing Claude Code plugin repositories

02Splitting a multi-purpose skill into domain-specific specialist modules

03Reducing context window noise by isolating tool-heavy logic

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamie-bitflight/claude_skills refactor-skill

For use in Claude.ai and ChatGPT

Download Skill