Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
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.
type
skill
category
writing
status
stable
origin
tibsfox
modified
false
first_seen
"2026-04-11T00:00:00.000Z"
first_path
examples/skills/writing/revision-editing/SKILL.md
superseded_by
null
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)
Work from large to small. Changes at a higher level may eliminate the need for changes at lower levels.
Level
Scope
Questions
Tools
1. Structural
Whole piece
Is the thesis/argument sound? Is the organization logical? Are sections in the right order? Is anything missing or redundant?
Reverse outline, cut test
2. Paragraph
Individual paragraphs
Does each paragraph have a controlling idea? Does it develop that idea fully? Do transitions connect paragraphs logically?
Topic sentence audit, coherence check
3. Sentence
Individual sentences
Is each sentence clear? Is the syntax effective? Are there deadwood words? Is the voice consistent?
Read-aloud test, sentence combining
4. Proofreading
Surface correctness
Spelling, punctuation, grammar, formatting, citation format
Print-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:
Deadwood
Replacement
"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:
Mini-lesson (5-10 minutes): the teacher demonstrates one specific technique.
Independent writing (20-30 minutes): students write while the teacher circulates.
Conferencing (during independent writing): one-on-one conversations between teacher and student about the student's work in progress.
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):
Praise: Name one specific thing that works well and explain why.
Question: Ask one genuine question about meaning, intent, or clarity.
Suggest: Offer one specific, actionable suggestion for revision.
The Liz Lerman Critical Response Process:
Responders state what was meaningful, evocative, or interesting.
The writer asks questions about the work.
Responders ask neutral questions ("What was your intention in the opening paragraph?").
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
Error
Diagnostic
Fix
Thesis drift
Reverse outline shows argument wandering
Restate thesis; cut or rewrite drifting sections
Paragraph sprawl
Paragraph covers 3+ ideas
Split into focused paragraphs
Evidence dumping
Quotes/data without analysis
Add reasoning after every piece of evidence
Hedging overload
"It could perhaps be argued that possibly..."
Commit to claims or cut them
Throat clearing
First paragraph restates the prompt or provides unnecessary context
Cut to the real opening
Conclusions that only summarize
"In conclusion, this essay discussed..."
End with implication, question, or call to action
Inconsistent tense
Past tense shifts to present and back
Pick 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.
