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>