Individual skill
s4h-writing-restructure
Diagnoses and repairs structural problems in non-fiction, essays, and documents — wrong order, buried lead, wrong ending, proportion errors. Use when a piece is in the wrong order, starts too late, or spends space on the wrong things. Triggers: 'the piece is in the wrong order', 'restructure', 'buries the lede', 'the structure is off', 'reorganise this', 'the ending is in the wrong place', 'takes too long to get to the point'.
skills/s4h-writing-restructure/SKILL.md
Source commit a30df8b67698ccb03ef5e35d68c2eddc5321ad3f
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Not checked yet
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 240
- Repository last updated
- Jul 15, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- claude-code Repository topic
- claude-code-plugin Repository topic
- cognitive-frameworks Repository topic
- creativity Repository topic
- decision-making Repository topic
- ethics Repository topic
- mental-models Repository topic
- problem-solving Repository topic
- reasoning Repository topic
- systems-thinking Repository topic
- writing Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 7,394 bytes
Read excerpt
# Writing: Restructure
Structural problems are the hardest to see from inside the piece — because from inside, structure is invisible. The writer always knows where they're going; they know the context, the backstory, why the claim matters. The reader only knows where they've been. The result: pieces that are perfectly clear to the writer and impenetrable to the reader, because the reader doesn't have the context that makes the opening make sense, doesn't know that the important claim is on page four, and has no way to distinguish the load-bearing material from the scaffolding.
Three structural failures account for the majority of structurally broken pieces:
**Burying the lead:** The piece starts with context, background, or setup rather than the claim or finding. The writer needed to write the setup to arrive at the claim. The reader doesn't need it — or needs a fraction of it, after the claim has been stated.
**Wrong ending:** The piece stops before it resolves. The real insight is in the second-to-last paragraph. The final paragraph is a softening or a retreat. Or the piece stops at the conclusion of the argument but before its implications — leaving the reader with the logic but not the meaning.
**Wrong proportion:** The piece spends three pages on the least important point and half a page on the most important one. The proportion reflects the order in which the writer discovered things, not the order of their importance.
All three failures have the same cause: the structure was not designed for the reader — it was inherited from the process of writing.
