Documentation Engineering

When to use

Invoke this skill to document code, write project READMEs, generate API specs, create user manuals, or co-author decision docs/proposals. This skill uses a strict, interactive co-authoring workflow to ensure the document works well when others read it.

Progressive Disclosure Rules

• Only load reference files if the user specifies a particular documentation framework (e.g., JSDoc, Docusaurus).

Standard Operating Procedure (SOP): Doc Co-Authoring Workflow

Always act as an active guide, explicitly walking the user through the following three phases sequentially. Do not rush to draft the entire document at once.

Phase 1: Context Gathering (Intent & Scoping)

Goal: Close the gap between what the user knows and what Claude knows, enabling smart guidance.