docs-refactor

Refactor CLAUDE.md, SKILL.md, and COMMAND.md to reduce token usage by 50%.

3|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/alpoxdev/claude-code --skill docs-refactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-refactor
Source: https://github.com/alpoxdev/claude-code/tree/main/.claude/skills/docs-refactor
Command: npx skills add https://github.com/alpoxdev/claude-code --skill docs-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

기존 Claude Code 문서의 토큰 과다 문제를 해결하고, CLAUDE.md, SKILL.md, COMMAND.md의 명확성과 유지보수성을 향상시킵니다.

Core Features & Use Cases

  • 토큰 효율화: 문서 전반의 불필요한 서술을 제거하고 핵심 주장과 예시를 간결하게 정리합니다.
  • 구조화된 포맷: 프런트매터와 표, 코드 예시를 표준화하여 탐색 및 재사용성을 높입니다.
  • 사용 사례: 대규모 코드베이스의 문서 리팩토링으로 50% 이상 토큰 절감이 필요한 프로젝트에 적용합니다.

Quick Start

Use the docs-refactor skill to analyze CLAUDE.md, SKILL.md, and COMMAND.md and produce a token-optimized rewrite plan.

Frequently Asked Questions about docs-refactor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce token usage in Claude Code documentation?

You can reduce token usage in Claude Code documentation by using a refactoring process that removes unnecessary narrative and standardizes structured frontmatter across CLAUDE.md, SKILL.md, and COMMAND.md files. This ensures readability while achieving a validated 50% token reduction.

What is the best way to refactor CLAUDE.md for token efficiency?

The best way to refactor CLAUDE.md for token efficiency is to enforce a structured frontmatter, minimize narrative text, and standardize tables and code examples. This preserves the core meaning while targeting a validated 50% token reduction in large repositories.

Can I use automated refactoring for SKILL.md and COMMAND.md files?

Yes, you can use automated refactoring for SKILL.md and COMMAND.md files. The process analyzes these files across documentation workflows to produce a token-optimized rewrite plan, ensuring structured formatting and minimal narrative.

When do I need to refactor documentation for token reduction?

You need to refactor documentation for token reduction when managing large codebases where CLAUDE.md, SKILL.md, and COMMAND.md files consume excessive tokens. This process ensures documentation maintains clarity and brevity while cutting token usage by 50%.

Are there limitations to token reduction in Claude Code documentation?

A key limitation of token reduction in Claude Code documentation is the strict requirement to achieve a validated 50% reduction before and after refactoring. This means the refactoring process must carefully preserve the original meaning while enforcing minimal narrative.