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>