Takes a draft with structural weaknesses and produces a concrete restructuring plan with recommended section order and reasoning.
How this skill is triggered — by the user, by Claude, or both
Slash command
/autopunk-media-skills:structure-improvement-advisorThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Takes a draft with identified or suspected structural weaknesses and produces a concrete restructuring plan — including a recommended section order and the reasoning behind each change.
Takes a draft with identified or suspected structural weaknesses and produces a concrete restructuring plan — including a recommended section order and the reasoning behind each change.
Required: The full draft text.
Optional: A description of the structural problem as you understand it (e.g. "the story buries the news," "the argument doesn't land until too late," "it feels like two separate pieces joined in the middle"). If an editor has given you notes, paste them in. Also useful: the target format (print feature, bulletin script, online explainer) and intended audience.
A restructuring plan in three parts:
Part 1 — Diagnosis (one short paragraph) What the draft's current structure is doing, and where it is working against the piece's purpose.
Part 2 — Recommended structure (numbered list) Each item is one block of the draft, identified by its opening words or a brief label, placed in the recommended new order. Each item includes:
Part 3 — Additional actions Any blocks that need splitting, merging, cutting, or new material to complete the restructure. Kept brief — enough to understand the decision, not a full rewrite.
The plan is a brief working document the writer can pin next to their draft as they restructure. Typically 400–600 words. Tone is direct and practical — decisions and reasons, not general editorial advice.
Format: Online long-read, general news audience Problem noted: "My editor said the piece doesn't earn its opening. The first scene is too big for where the story starts." Draft:
[Block A] The appeal hearing lasted eleven minutes. After three years of legal proceedings, a wrongful dismissal case that had drawn national attention ended with a brief statement from the bench and a handshake that nobody offered. Daniel Forsythe walked out of the building alone.
[Block B] Forsythe had worked as a safety inspector for a regional transport authority for fourteen years. He was dismissed without notice in the spring of a year when the authority was under pressure over a series of inspection failures that had been reported in local media.
[Block C] The transport authority declined to comment for this article. Its legal representatives confirmed in a written statement that all proceedings had concluded and that the authority considered the matter closed.
[Block D] The inspection failures that preceded Forsythe's dismissal had been flagged internally. Documents obtained under freedom of information law show that Forsythe submitted three written safety reports in the eight months before he was let go. Two of the three reports were not circulated to senior management.
[Block E] Whistleblower protection law in this jurisdiction covers employees who report regulatory breaches through official internal channels. Forsythe used the official internal reporting system for all three submissions. Whether that affords him legal protection was the central question of the appeal.
[Block F] The appeal tribunal found against him on a procedural point: his legal team had missed a filing deadline. The substantive question — whether suppressing safety reports constitutes grounds for whistleblower protection — was never ruled on.
[Block G] He is considering a further application to a higher tribunal. His solicitor says the procedural point may itself be challengeable. That process, if it proceeds, could take another two years.
[Block H] Three of the inspection failures flagged in Forsythe's suppressed reports were later identified in an independent audit commissioned by the authority. The audit's recommendations have been partially implemented.
Restructuring Plan — Online Long-Read
Diagnosis
The current structure opens with the appeal outcome (Block A) before the reader understands what the appeal was about, who Forsythe is, or why his situation matters. The opening scene is genuinely strong — but it requires context the reader does not yet have to register its weight. The middle of the draft (Blocks D–F) is where the story's real substance lives, and it arrives too late. The authority's no-comment (Block C) is currently placed as if it resolves something, but it appears before the reader knows what is being alleged.
Recommended structure
Block B — Establishes who Forsythe is and his relationship to the authority The reader needs this before the appeal scene will mean anything. Fourteen years in the role, the inspection pressure, the dismissal — this is the ground the whole piece stands on.
Block D — Presents the core allegation: safety reports submitted, two suppressed Placed second so the reader understands what Forsythe actually did before entering the legal dimension. The FOI documents give this block hard factual weight — it earns its position.
Block E — Explains the legal framework: whistleblower protection and how it applies The law is context for the appeal, not backstory. It sits here so the reader arrives at the appeal already understanding what was at stake.
Block A — The appeal scene: eleven minutes, no handshake, Forsythe walks out alone Now this scene lands. The reader knows who he is, what he reported, and what the hearing was supposed to decide. The brevity of the outcome reads as devastating rather than confusing.
Block F — The tribunal's finding: procedural defeat, substantive question unresolved Follows directly from the appeal scene. Explains the eleven minutes. The unresolved whistleblower question is now the piece's unresolved question — which carries the reader forward.
Block H — The suppressed reports' findings were later confirmed by an independent audit Placed here for maximum impact: the safety concerns Forsythe raised were real, and the authority subsequently acknowledged them. This is the piece's most damaging finding and belongs near the close.
Block C — Authority declines to comment; considers matter closed Now this reads as refusal to engage with what the reader has just learned, rather than a neutral procedural note. Its placement after Block H gives it meaning.
Block G — Further legal steps possible; two more years Closes the piece on an open horizon. The reader leaves with the story unfinished, which is honest, and with the sense that the substantive question is still unanswered, which is the point.
Additional actions
npx claudepluginhub ur-grue/autopunk-media-skills --plugin autopunk-media-skillsAnalyzes draft article structure—paragraph order, logical flow, redundancies, pacing—and returns a diagnostic report with reordering, cutting, or restructuring recommendations.
Diagnoses and repairs structural problems in non-fiction, essays, and documents — wrong order, buried lead, wrong ending, proportion errors.
Reviews article drafts section by section for structural logic, concept ordering, and prose clarity. Preserves core arguments while cutting repetition.