When should I use the refactoring-skills command?

You should use it when your project skills become messy, overlapping, or redundant, or when you notice the same instructions appearing in multiple SKILL.md files.

What is the refactoring-skills skill?

It is a specialized tool for Claude Code that helps manage and clean up other skills within a project by applying clean code principles to documentation.

How does it handle duplicated conventions?

It identifies shared constraints across multiple skills and uses the 'writing-rules' capability to extract them into global rule files, reducing skill size and complexity.

Will this skill delete my work automatically?

No, it follows a structured 'Analyze and Classify' phase where it identifies skills for deletion based on redundancy, but actions are executed as part of a transparent task list.

What are the core principles of skill refactoring?

The core principles are: fewer focused skills are better than many overlapping ones, and that documentation should follow the same DRY (Don't Repeat Yourself) principles as code.

Refactoring Skills Manager

Name: Refactoring Skills Manager
Author: wayne930242

bywayne930242

•

Productivity & Workflow

Refactors and consolidates Claude Code skills by applying clean code principles to documentation and workflow definitions.

The Refactoring Skills skill is a specialized utility for the Reflexive-Claude-Code (RCC) ecosystem designed to eliminate 'skill bloat' and redundancy in AI agent configurations. It guides Claude through a rigorous six-step workflow—discovery, classification, execution, extraction, validation, and reporting—to ensure that project-specific capabilities remain modular and maintainable. By identifying overlapping instructions and extracting shared conventions into global rules, it optimizes the context engineering process, resulting in more focused and efficient AI behavior.

Key Features

01Extraction of duplicated conventions into reusable project rule files

02Matrix-based classification to Keep, Refactor, Merge, Extract, or Delete skills

03Detailed reporting of all modifications, merges, and architectural recommendations

048 GitHub stars

05Automated discovery of SKILL.md files across project and user directories

06Structured task initialization and validation to ensure zero-loss refactoring

Use Cases

01Performing periodic audits of an Agentic Context Engineering workflow to maintain performance

02Consolidating redundant documentation patterns into a unified rule-set for better context management

03Cleaning up a messy or overlapping set of custom project skills during scaling

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add wayne930242/reflexive-claude-code refactoring-skills

For use in Claude.ai and ChatGPT

Download Skill