| name | doc-refactor |
| description | Refactor documents — simplify without losing information, visualize flows with sequenceDiagram. |
| allowed-tools | Read, Grep, Glob, Edit, Agent |
Document Refactoring
Trigger
- Keywords: refactor doc, simplify document, doc-refactor, condense document
When NOT to Use
- Code refactoring (use
/simplify or /refactor)
- Document review without changes (use
/codex-review-doc)
- Writing new documents (use
/tech-spec or /create-request)
Agent Dispatch
Dispatch to the dedicated doc-refactor agent:
Agent({
description: "Refactor document — simplify without losing information",
subagent_type: "doc-refactor",
prompt: `Refactor the document at: $ARGUMENTS
Follow the task steps and simplification standards defined in this skill.`
})
Task
For the file specified by $ARGUMENTS:
-
Analyze original content
- Count lines
- Identify core information vs redundancy
-
Refactor
- Long paragraphs -> tables
- Steps -> sequenceDiagram
- Duplicates -> single source
-
Validate
- Key information preserved
- Line count reduced
Simplification Standards
| File Type | Target Lines |
|---|
| CLAUDE.md | < 50 |
| rules/*.md | < 30 |
| agents/*.md | < 50 |
Output
## Refactoring Result
- Original: X lines
- Simplified: Y lines (-Z%)
## Changes
- <summary>
