editorial-review

Solid

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.

Code & Development 10 stars 1 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 82/100

Stars 20%
35
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Editorial Review (structural pass) Critique and tighten a long deliverable's **argument architecture** — then hand the prose off to the humanization layer. This skill operates on structure only; it never rewrites sentences and never challenges the ideas. The full method (document arcs, operation vocabulary, defect checklist, the hard boundary with `humanization.md`) lives in `reference/editorial-review.md`. Load it; do not restate it here. --- ## Phase 0: Load context 1. Read `reference/editorial-review.md` (the document-model arcs, the operation vocabulary, the defect checklist, the boundary table). 2. Read `.claude/rules/humanization.md` — confirm the boundary: this skill stops at the paragraph; everything below it (rhythm, specificity, banned vocabulary, the calibration gate) belongs to that rule. 3. Read the target document **in full** (the `file:<path>` argument, or the pasted text). Never review a draft you have only skimmed. ## Phase 1: Structural pass 1. **Select one document model** from `reference/editorial-review.md` (proposal arc, intel-brief arc, investor-narrative arc, argument/decision-note arc, or a generic model). State the choice and its primary rule in one sentence: "This deliverable should follow the {model}; its primary rule is {rule}." 2. **Map the structure** — list each major section with an approximate word count. This forces measurement before recommendation. 3. **Walk the defect checklist** (orphan section, claim-without-evidence, evidence-...

Details

Author
mishahanin
Repository
mishahanin/heading-os
Created
4 weeks ago
Last Updated
today
Language
Python
License
Apache-2.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Listed

paper-revision-editor

Revise, copy-edit, line-edit, polish, tighten, or give editorial feedback on an academic paper section; make it clearer to non-specialists, less AI-sounding and more human to read; read a whole paper cold as its intended reader and report where it stops working; check cross-section consistency; cut a section toward a length limit; respond to reviewer comments; draft, improve, or tighten a response-to-reviewers letter; route number checks against the repository data and analysis pipeline, figure regeneration, and new analyses to the gated analyst lane (/paper:verify-numbers, /paper:figures, /paper:analyze), and citation or novelty checks to the gated scholar lane (/paper:scholar). Diagnoses logical flow, argumentation, exposition, narrative spine, copyediting, and reader experience while preserving voice, citations, and numerical claims. Not for drafting new sections from notes, citation formatting or BibTeX, LaTeX compilation, pure typo lists, or non-academic prose.

3 Updated yesterday
ipeirotis
Data & Documents Listed

blue-pencil

Revise, copy-edit, line-edit, polish, tighten, or give editorial feedback on an academic paper section; make it clearer to non-specialists, less AI-sounding and more human to read; read a whole paper cold as its intended reader and report where it stops working; check cross-section consistency; cut a section toward a length limit; respond to reviewer comments; draft, improve, or tighten a response-to-reviewers letter; route number checks against the repository data and analysis pipeline, figure regeneration, and new analyses to the gated analyst lane (/paper:verify-numbers, /paper:figures, /paper:analyze), and citation or novelty checks to the gated scholar lane (/paper:scholar). Diagnoses logical flow, argumentation, exposition, narrative spine, copyediting, and reader experience while preserving voice, citations, and numerical claims. Not for drafting new sections from notes, citation formatting or BibTeX, LaTeX compilation, pure typo lists, or non-academic prose.

3 Updated yesterday
ipeirotis
AI & Automation Listed

claudemd-review

Use right after being corrected on something a CLAUDE.md file should already have told you, when explicitly asked to review CLAUDE.md, or periodically after a session with a lot of back-and-forth — reviews THIS conversation for friction and proposes a bounded CLAUDE.md edit. A lightweight, single-session complement to skill-tuning-loop (which mines many sessions and validates a proposal against held-out cases before surfacing it — reach for that instead when the ask is "make this systematic," not "check right now"). Own version of the dx plugin's `/dx:review-claudemd`.

1 Updated today
patrickserrano