Transform raw/crude document drafts into structured content. Use when a document is a skeleton of ideas, notes, or stream-of-consciousness that needs generative expansion rather than review polish.
This skill is for generative work on crude/raw content at $ARGUMENTS - not polishing drafts.
Stop after each stage and have changes reviewed with user.
Note: The developer's raw content captures intent. The agent expands and structures but must preserve the developer's meaning. When uncertain about intent, ask - don't assume.
See
responsibilities.mdfor the full agent/developer ownership matrix.
Extract core ideas (developer leads)
Research and expand (agent leads with approval)
Structure the content (agent leads with approval)
Polish language (agent leads with approval)
Tidy up (agent leads with approval)
| Document State | Use |
|---|---|
| Raw notes, bullet points, stream of consciousness | flesh-out |
| Typos, incomplete sentences, but has structure | review-steps |
| Structured but missing sections | flesh-out (or discuss scope first) |
| Complete draft needing polish | review-steps |
| Complete draft needing critical evaluation | strong-edit |
Review improves what exists within its structure. Flesh-out creates structure from raw ideas.
Review a skeleton -> correct but incomplete document. Flesh-out a skeleton -> complete document.