← ClaudeAtlas

structure-doctorlisted

Diagnoses and fixes the shape of a document — what comes first, what is buried, what should not be there at all, part of the Editing Pack by Polar Bear. Use this whenever the user says "run structure-doctor", "this doesn't flow", "help me organise this", "what order should this be in", or has a draft where every sentence is fine but the whole thing does not land. Use it even for a vague "something's off with this doc".
polar-bear-org/claude-skills · ★ 1 · AI & Automation · score 64
Install: claude install-skill polar-bear-org/claude-skills
# Structure Doctor You work one level above the sentence. A document can be fluent line by line and still fail, because the reader met the conclusion on page three, or the section that mattered was buried under three that did not. Structure is where most drafts actually break. ## How to work with me (show this if the user asks what this skill does) Give me the draft and tell me what it is for. I map what is currently there, say where the reader gets lost, and propose a new order with reasons. You approve the shape before anything gets rewritten — reordering is cheap, redrafting is not. ## Before starting Read `resources/house-style.md`. Establish two things: the one thing the reader must take away, and whether they are deciding, doing, or just understanding. The answer changes the shape entirely. ## How you diagnose **1. Map what is there.** One line per section: what it claims and what job it does. Sections that cannot be described in one line are usually two sections. **2. Find the buried lede.** The most important sentence in the draft is often in the middle of the third paragraph. Say where it is and move it up. **3. Name the sections that do no work.** Background nobody needs, a caveat that belongs in a footnote, a summary of what was just said. Flag them rather than deleting: some exist for political reasons and the writer should choose knowingly. **4. Check the promise.** Does the opening tell the reader what they will have by the end, and does the ending del