structure-improvement-advisor

Solid

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.

AI & Automation 16 stars 0 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 86/100

Stars 20%
41
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Structure Improvement Advisor ## What This Skill Does 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. ## When To Use This Skill - After running a structure flow check and you have a list of problems, but you are not sure how to fix them without unravelling the whole piece - When a draft exists but feels fundamentally hard to follow, and you need a clear plan before you rewrite rather than redrafting blindly - When you want to experiment with an alternative structure — inverted pyramid, narrative chronology, thematic blocks — without committing to a full rewrite first - When an editor has returned a draft with "needs restructuring" notes and you need to translate vague feedback into specific moves ## What You Need To Provide **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. ## How the Assistant Approaches This 1. Reads the draft and identifies its natural units — the distinct blocks of information, each of which does a single job (establishes context, introduces a person, presents evidence...

Details

Author
ur-grue
Repository
ur-grue/autopunk-media-skills
Created
4 months ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

structure-flow-checker

Analyses a draft for logical sequence, narrative coherence, and transitions, then reports exactly where the structure breaks down and why.

16 Updated yesterday
ur-grue
AI & Automation Solid

writing-style

Structural pattern analysis for writing-mode review. Performs paragraph-level decomposition and pattern aggregation. Invoked by the team lead during editorial review.

82 Updated 4 days ago
DheerG
Code & Development Solid

editorial-review

Document-level STRUCTURAL editor for long deliverables. Reviews a draft's argument architecture -- section ordering, claim-to-evidence linkage, hierarchy, redundancy, buried lede, missing sections -- and proposes CUT / MERGE / MOVE / CONDENSE / SPLIT / ADD / PROMOTE / PRESERVE operations with word-savings estimates, BEFORE any sentence is touched. Content is sacrosanct: it reorganizes, it never argues with the ideas. Phase 2 hands all sentence-level work (rhythm, specificity, vocabulary) to the always-on humanization.md prose rule -- it never duplicates that. Use when the user says "editorial pass", "structural review", "review the structure of this", "tighten this document", "restructure this draft", or wants a long proposal / brief / report's argument arc checked. Do NOT use for: sentence-level prose / "make this sound human" (that is humanization.md), typo or grammar fixes (sanitize-text + humanization-check), fact-checking (/validate), artifact grading (/evaluate), short chat replies, or atomic /zk notes.

10 Updated today
mishahanin