Document Refactoring
Trigger
- Keywords: refactor doc, simplify document, doc-refactor, condense document
When NOT to Use
- Code refactoring (use
/simplifyor/refactor) - Document review without changes (use
/codex-review-doc) - Writing new documents (use
/tech-specor/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>