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'.

242 stars 25 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add human-avatar/skills-for-humanity --skill s4h-writing-restructure
Manual install
git clone --depth 1 https://github.com/human-avatar/skills-for-humanity.git /tmp/skills-for-humanity
mkdir -p ~/.claude/skills
cp -r /tmp/skills-for-humanity/skills/s4h-writing-restructure ~/.claude/skills/s4h-writing-restructure

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 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.
Read the full skill on GitHub

Details

Skill name
s4h-writing-restructure
Path
skills/s4h-writing-restructure/SKILL.md
License
MIT
Repo updated
15 July 2026

FAQ

What does the S4h Writing Restructure skill do?

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'.

How do I install the S4h Writing Restructure skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add human-avatar/skills-for-humanity --skill s4h-writing-restructure. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is S4h Writing Restructure popular?

It lives in human-avatar/skills-for-humanity, which has 242 GitHub stars and 25 forks, and is included in 1 curated skill list.

Related skills

S4h

242

human-avatar/skills-for-humanity

Master orchestration skill. Takes any situation in plain English, identifies the underlying goal, designs a multi-skill reasoning workflow, and executes it sequentially — feeding each skill's output into the next. Use when you say 'help me think through this', 'I need to figure out what to do', 'where do I start', or any time you want structured thinking applied end-to-end rather than routed to a single tool.

Testing & QAIn 1 list25

S4h Aesthetic

242

human-avatar/skills-for-humanity

Entry point for the aesthetic toolkit. Routes to the right aesthetic skill based on your situation. Use when you say 'aesthetic', 'check the design', 'does this feel right', 'is this elegant', 'is this too complex', 'what pattern is this', 'find the simpler version', or want an aesthetic lens applied without knowing which specific tool fits.

OtherIn 1 list25

S4h Aesthetic Coherence Check

242

human-avatar/skills-for-humanity

Tests whether the parts of something form a unified whole — finding the jarring inconsistencies that accumulate when different contributors work without a shared vision. TRIGGERS: 'coherence check', 'does this feel unified', 'something feels off', 'inconsistent', 'check the whole', 'does this hang together'.

Testing & QAIn 1 list25

S4h Writing Rhetoric

242

human-avatar/skills-for-humanity

Analyses what a piece of writing is doing rhetorically — its rhetorical situation, explicit argument vs. buried frame, appeals map, and loaded language. Use to surface assumptions, examine persuasion techniques, or understand how a piece is working. Triggers: 'rhetorical analysis', 'what is this piece doing rhetorically', 'rhetoric', 'analyze this argument', 'how is this persuasive', 'what assumptions is this making', 'loaded language', 'hidden assumptions', 'what is this piece really arguing'.

Writing & ContentIn 1 list25

S4h Writing Report

242

human-avatar/skills-for-humanity

Writes and audits business reports, briefing documents, and information reports for answer-first structure, precision, hierarchy, and navigability. Use when a report buries its findings, is written for the writer rather than the reader, or lacks clear structure. Triggers: 'write a report', 'report writing', 'business report', 'briefing document', 'information report', 'research summary', 'the report isn't clear', 'buries the findings'.

Writing & ContentIn 1 list25

S4h Writing Scene Construction

242

human-avatar/skills-for-humanity

Diagnoses and repairs individual scenes using the want/obstacle/outcome framework. Every scene must change the story's state. Use when a scene feels flat, static, or purposeless. Triggers: 'this scene isn't working', 'scene construction', 'scene feels flat', 'scene review', 'fix this scene', 'the scene doesn't do anything', 'should I cut this scene'.

Writing & ContentIn 1 list25

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.