/doc-refactor

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`:

1. **Analyze original content**

• Count lines
• Identify core information vs redundancy

2. **Refactor**

• Long paragraphs -> tables
• Steps -> sequenceDiagram
• Duplicates -> single source

3. **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>