Does this skill delete my existing instructions?

It flags redundant or vague instructions for deletion and asks for confirmation on contradictions, ensuring you retain full control over your project guidelines.

Why should I refactor my context files?

Large, unorganized files consume more tokens and can cause the AI to miss important instructions. Refactoring improves agent focus, reduces errors, and saves costs.

Can I use this for AGENTS.md too?

Yes, the skill is designed to handle both CLAUDE.md and AGENTS.md files interchangeably as they serve the same purpose for AI agents.

What is progressive disclosure for CLAUDE.md?

It is a technique where only the most essential information is kept in the root file, while detailed instructions are moved to specific sub-files, preventing the AI from being overwhelmed by irrelevant context.

CLAUDE.md Refactor

Name: CLAUDE.md Refactor
Author: OSSystems

byOSSystems

0•

학습 및 문서화

Optimizes project context files by applying progressive disclosure principles to structure CLAUDE.md and AGENTS.md efficiently.

This skill reorganizes large, cluttered CLAUDE.md or AGENTS.md files into a manageable, hierarchical structure to improve AI agent performance and reduce context noise. By identifying core essentials for the root file and moving domain-specific instructions into specialized sub-documents, it ensures the AI focuses on what is truly relevant to the current task. The skill automatically identifies contradictions, flags redundant fluff like 'write clean code', and suggests a clean documentation folder structure based on industry best practices for AI-assisted development.

주요 기능

01Identifies and resolves contradictory instructions within context files

02Segregates detailed conventions into specialized markdown files

03Implements a logical hierarchical folder structure for documentation

040 GitHub stars

05Flags and removes redundant or non-actionable instructions

06Extracts essential project-wide commands and metadata for the root file

사용 사례

01Standardizing project instructions across a multi-repo organization for consistent AI behavior

02Cleaning up an oversized CLAUDE.md file that has become too noisy for the AI to follow accurately

03Onboarding a new AI agent to a complex codebase by providing clear, tiered documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ossystems/claude-code-plugin refactor-claude-md

For use in Claude.ai and ChatGPT

Download Skill