docs-refactor

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

3|Updated Nov 30, 2025
Ready to run
npx skills add https://github.com/alpoxdev/claude-code --skill docs-refactor
๐Ÿ’ฌ Prompt for ChatGPT / Claude Chatโ–ผ
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.