Gsd-skill-creator revision-editing

Revision and editing strategies for all writing forms. Covers the revision hierarchy (structural revision, paragraph-level revision, sentence-level editing, proofreading), structural revision techniques (reverse outline, cut test, resequencing, scope audit), paragraph and sentence editing (coherence check, topic sentence audit, sentence combining, deadwood removal, passive voice audit), the workshop model (Calkins Writers Workshop, peer feedback protocols, conferencing, response letters), self-editing techniques (read-aloud test, print-and-mark, time gap, checklist protocols), and common error patterns with diagnostic fixes. Use when revising drafts, editing for clarity, running workshops, or teaching the revision process.

install
source · Clone the upstream repo
git clone https://github.com/Tibsfox/gsd-skill-creator
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Tibsfox/gsd-skill-creator "$T" && mkdir -p ~/.claude/skills && cp -r "$T/examples/skills/writing/revision-editing" ~/.claude/skills/tibsfox-gsd-skill-creator-revision-editing && rm -rf "$T"
manifest: examples/skills/writing/revision-editing/SKILL.md
source content

Revision & Editing

Revision is not fixing mistakes. Revision is re-seeing -- re-envisioning the piece's purpose, structure, and effect. Editing is the subsequent craft of refining sentences and correcting errors. The distinction matters because writers who jump to editing before revising polish sentences that should be cut, reorder paragraphs in a structure that needs rebuilding, and fix commas in an argument that does not work. This skill covers the full hierarchy from structural revision through proofreading, the workshop model, and self-editing techniques.

Agent affinity: strunk (sentence-level editing, economy), orwell (clarity, deadwood removal), calkins (workshop process, conferencing), baldwin (revision as deepening of thought)

Concept IDs: writ-revision-strategies, writ-peer-feedback, writ-drafting-discovery, writ-voice-development

Part I -- The Revision Hierarchy

Four Levels of Revision

Work from large to small. Changes at a higher level may eliminate the need for changes at lower levels.

LevelScopeQuestionsTools
1. StructuralWhole pieceIs the thesis/argument sound? Is the organization logical? Are sections in the right order? Is anything missing or redundant?Reverse outline, cut test
2. ParagraphIndividual paragraphsDoes each paragraph have a controlling idea? Does it develop that idea fully? Do transitions connect paragraphs logically?Topic sentence audit, coherence check
3. SentenceIndividual sentencesIs each sentence clear? Is the syntax effective? Are there deadwood words? Is the voice consistent?Read-aloud test, sentence combining
4. ProofreadingSurface correctnessSpelling, punctuation, grammar, formatting, citation formatPrint-and-mark, checklist

The most common revision error. Starting at Level 4. Proofreading a structurally flawed piece is wasted labor. Always begin at Level 1.

Part II -- Structural Revision

Reverse Outline

After drafting, outline what you actually wrote (not what you planned to write). For each paragraph, write one sentence stating its main point. Read only these sentences in sequence. Does the argument progress logically? Are there repetitions? Gaps? Non sequiturs?

What the reverse outline reveals:

  • Paragraphs with no clear main point (candidates for cutting or splitting)
  • Points that appear in the wrong order
  • Missing steps in the argument (gaps the writer bridged mentally but the reader cannot)
  • Repeated points (often disguised by different examples)

The Cut Test

For every section, paragraph, or sentence you suspect may be unnecessary, remove it and read the surrounding text. If the piece reads better or equally well without it, the cut stands. If meaning is lost, restore it.

Strunk's law. "Omit needless words." Extended to all scales: omit needless sentences, needless paragraphs, needless sections. A shorter piece is not automatically better, but every word should earn its place.

Resequencing

Sometimes the right content is in the wrong order. Common resequencing moves:

  • Move the thesis earlier. Academic and journalistic writing benefits from front-loading the main claim. If the thesis appears on page 3, the reader spent two pages without orientation.
  • Move the strongest evidence first (or last, for climactic structure).
  • Move background to an appendix or footnote if it interrupts the argument's momentum.

Scope Audit

Is the piece trying to do too much? A 2,000-word essay that attempts to cover five major claims will treat each superficially. Better to narrow the scope and develop one or two claims thoroughly. The scope audit asks: "Given the length and form, how many ideas can this piece develop well?"

Part III -- Paragraph and Sentence Editing

Coherence Check

Read each paragraph asking: does every sentence connect to the one before it? The known-new contract requires that each sentence begins with something already established and ends with something new. When this chain breaks, the reader stumbles.

Topic Sentence Audit

Highlight the first sentence of every paragraph. Read only those sentences. If they form a coherent argument summary, the paragraphs are well-organized. If not, revise topic sentences until they do.

Sentence Combining

Short, choppy sentences in sequence create a monotonous rhythm and fail to show logical relationships between ideas.

Before: "The experiment failed. The sample was contaminated. The researchers had to start over."

After: "Because the sample was contaminated, the experiment failed, and the researchers had to start over."

Combining makes the causal relationship explicit and varies the rhythm.

Deadwood Removal

Words and phrases that add length without meaning:

DeadwoodReplacement
"in order to""to"
"at this point in time""now"
"due to the fact that""because"
"it is important to note that"(cut entirely)
"the fact that"(rephrase)
"there are many X that""many X"
"in terms of"(rephrase)
"very," "really," "quite," "rather"(cut or find a precise adjective)

Passive Voice Audit

Passive voice ("the ball was thrown by the boy") has legitimate uses: when the agent is unknown, unimportant, or deliberately obscured. But habitual passive voice weakens prose by hiding who does what. The audit: for each passive construction, ask whether the active version is clearer. If yes, convert.

Part IV -- The Workshop Model

Calkins Writers Workshop

Lucy Calkins's Writers Workshop model structures writing instruction around the writing process itself, not around assignment-and-grade cycles.

Workshop structure:

  1. Mini-lesson (5-10 minutes): the teacher demonstrates one specific technique.
  2. Independent writing (20-30 minutes): students write while the teacher circulates.
  3. Conferencing (during independent writing): one-on-one conversations between teacher and student about the student's work in progress.
  4. Sharing (5-10 minutes): selected students share work and receive peer feedback.

Why it works. Writing improves through practice and targeted feedback, not through lectures about writing. The workshop creates protected time for both.

Peer Feedback Protocols

Effective peer feedback requires structure. Unstructured "what do you think?" invitations produce either false praise or unhelpful criticism.

The PQS Protocol (Praise, Question, Suggest):

  1. Praise: Name one specific thing that works well and explain why.
  2. Question: Ask one genuine question about meaning, intent, or clarity.
  3. Suggest: Offer one specific, actionable suggestion for revision.

The Liz Lerman Critical Response Process:

  1. Responders state what was meaningful, evocative, or interesting.
  2. The writer asks questions about the work.
  3. Responders ask neutral questions ("What was your intention in the opening paragraph?").
  4. Responders offer opinions, framed as "I have an opinion about X; do you want to hear it?" The writer decides.

Conferencing

One-on-one conversation between teacher/editor and writer. The goal is not to tell the writer what to fix but to help the writer discover what the piece needs.

Conferencing moves:

  • "What is this piece really about?" (Helps the writer find the through-line)
  • "What is the one thing you want the reader to take away?" (Forces prioritization)
  • "Which part are you most satisfied with?" (Reveals the writer's sense of their own strengths)
  • "Where did you get stuck?" (Identifies the productive revision entry point)

Part V -- Self-Editing Techniques

The Read-Aloud Test

Read the piece aloud, or have a text-to-speech tool read it. The ear catches what the eye skips: awkward rhythms, repeated words, unclear syntax, sentences that run out of breath, transitions that do not connect. If you stumble while reading aloud, the reader will stumble silently.

Print-and-Mark

Print the piece and mark it with a pen. The physical medium changes the reader's relationship to the text -- it becomes an object to be examined rather than a screen to be scrolled past. Mark passages that feel slow, transitions that do not work, sentences that need tightening.

The Time Gap

Put the draft away for at least 24 hours before revising. The time gap breaks the writer's familiarity with the text and allows them to read it as a reader would -- encountering it fresh, noticing what is actually on the page rather than what the writer intended to put there.

Checklist Protocols

For recurring tasks (blog posts, reports, academic papers), build a revision checklist specific to the form. Run the checklist every time. Checklists prevent the human tendency to focus on what feels most urgent and neglect systematic coverage.

Sample expository essay checklist:

  • Thesis stated in introduction
  • Each paragraph has a topic sentence
  • Evidence cited for every claim
  • Counterargument addressed
  • Transitions connect paragraphs
  • Conclusion goes beyond summary
  • Read aloud for rhythm
  • Deadwood removed
  • Passive voice justified where used
  • Citations formatted correctly

Part VI -- Common Error Patterns

ErrorDiagnosticFix
Thesis driftReverse outline shows argument wanderingRestate thesis; cut or rewrite drifting sections
Paragraph sprawlParagraph covers 3+ ideasSplit into focused paragraphs
Evidence dumpingQuotes/data without analysisAdd reasoning after every piece of evidence
Hedging overload"It could perhaps be argued that possibly..."Commit to claims or cut them
Throat clearingFirst paragraph restates the prompt or provides unnecessary contextCut to the real opening
Conclusions that only summarize"In conclusion, this essay discussed..."End with implication, question, or call to action
Inconsistent tensePast tense shifts to present and backPick one tense for narration, one for analysis; maintain throughout

Cross-References

  • strunk agent: Economy of language, sentence-level editing. The primary agent for tightening prose.
  • orwell agent: Clarity, deadwood detection, anti-jargon. Works at both sentence and structural levels.
  • calkins agent: Workshop pedagogy, conferencing, process writing. The primary agent for teaching revision.
  • baldwin agent: Revision as deepening of thought, not just surface correction.
  • expository-writing skill: The structures that revision refines.
  • voice-style skill: How revision can strengthen or weaken voice.

References

  • Strunk, W., Jr., & White, E. B. (1959). The Elements of Style. Macmillan.
  • Calkins, L. (1994). The Art of Teaching Writing. Rev. ed. Heinemann.
  • Lerman, L. (2003). Liz Lerman's Critical Response Process. Dance Exchange.
  • Murray, D. (1978). "Internal Revision: A Process of Discovery." In Research on Composing, ed. Cooper & Odell. NCTE.
  • Elbow, P. (1973). Writing Without Teachers. Oxford University Press.
  • Orwell, G. (1946). "Politics and the English Language." Horizon.
  • Hugo, R. (1979). The Triggering Town. Norton.