proofread
Skill1 starsChanged 25 days agoMITView on GitHub
Proofread a fiction manuscript or a formatted proof — the final pass before publication. Catches typographical errors, dropped and duplicated words, punctuation and spacing slips, lost formatting, conversion damage between the edited manuscript and the typeset file, and front/back matter problems, without making new editorial decisions. Produces an errata list for the typesetter, a query list for anything needing a decision, and document checks. Use when the author asks for a proofread, final proof, last-pass check, manuscript check before formatting, ebook or print proof check, or a correction list before publishing.
26 other projects use a version of this.
Adopted by
Most recently taken up by
- pedrohcgs/claude-code-my-workflowtheir own version, first seen Nov 8, 2026
- NilsHellwig/acl-paper-skillstheir own version, first seen Nov 8, 2026
- flonat/flonat-researchtheir own version, first seen Nov 3, 2026
- obviousbread/docs-skillstheir own version, first seen Nov 1, 2026
- shuymn/skillstheir own version, first seen Nov 1, 2026
- dewil/claude-toolkittheir own version, first seen Nov 1, 2026
Used with
Projects with it also use humanize, deploy and 2 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
eherrerosjSkillhumanize
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive 'Signs of AI writing' guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases. Triggers on: 'humanize', 'make this sound human', 'remove AI writing', 'de-AI', 'sound more natural', 'less robotic', 'too AI-sounding', or when reviewing text that reads like AI output.
Also in 3 projects that use this
VercelSkilldeploy
Deploy applications to Vercel. Use when the user says "deploy", "deploy to Vercel", "push to production", "deploy my app", or "go live".
Also in 3 projects that use this
Microsoft AzureSkillverify
End-to-end app testing pipeline for browser-based web apps on cloud browsers via Azure Playwright Workspaces: verify the live app, author tests for working flows, heal failing tests, then re-run with video and produce one consolidated report. Three phases (app verification, test authoring, test healing) plus a scoped final sanity run; each phase emits a sub-report. Use when asked to "verify my app", "make sure my app works and has good test coverage", "do a full QA pass", "add tests where I'm missing coverage", "fix failing tests and add new ones", "smoke test before deploy", "QA my deployment", or any combined verify-and-test ask. Requires Azure CLI (`az login`) and a Playwright Workspace resource ID — bootstraps configs on first invocation. Browser-based web apps with Playwright only — not for unit/API tests, native mobile/desktop, load/perf, or full accessibility audits.
Also in 3 projects that use this
SentrySkillreview
Fixture review skill.
Also in 3 projects that use this
Other versions26 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 26
- pedrohcgs/claude-code-my-workflow★ 1.7ksame name
- flonat/flonat-research★ 150same name
- maxwell2732/paper-replicate-agent-demo★ 134same name
- sonilo-ai/skills★ 117same name
- maxwell2732/my-submission-formatting-agent★ 106same name
- tance-mang/chinese-webnovel-skills★ 97same name
- JakobThumm/proofreading★ 38same name
- christopherkenny/skills★ 26same name
- AlessandroCaforio/Academic-Writing★ 17same name
- amondnet/yoonmoon★ 17same name
16 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository4 other files it gives its agents.
- character-interviewSkill
- copyeditSkill
- developmental-editSkill
- line-editSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
15 rules. 0 are common, 6 are distinctive, and 9 are very specific to this project.
0
Common
Most of the 20 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
9
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 21
If you can't, at minimum run this pass in a different session or a different model from the one that copyedited.
- Distinctive: line 27
The style sheet is law: Every existing style decision stands, even the ones you would not have made.
- Very specific: line 30
Never rewrite a sentence: If the prose is poor, that is not a typo — flag it for line-edit and move on.
- Distinctive: line 32
Work the text, not your memory of it: Do not skip a passage because a prior pass covered it.
- Distinctive: line 59
Never invent a second layout.
- Very specific: line 81
Verify the gate: If copyedit/queries.md has open queries, stop.
- Distinctive: line 89
Read the style sheet completely, including the Do Not Change list.
- Very specific: line 96
Run the pattern checks in references/proofreading-checks.md.
- Very specific: line 104
Only when a formatted artifact exists.
- Very specific: line 110
Read the text with one category of error in mind per pass, not everything at once — the technique in references/reading-techniques.md.
- Distinctive: line 112
Do not read for story. Do not stop to admire or fix prose.
- Very specific: line 120
Write errata.md — numbered corrections, located, with original and corrected text.
- Very specific: line 121
Write queries.md — anything needing a decision.
- Very specific: line 122
Write checks.md — each check passed, failed, or not applicable.
- Very specific: line 123
Write summary.md from assets/templates/summary.md.
“Common” is measured: kept by at least 6 in 10 of the 20 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Proofread
The last pass. Find what is still wrong and report it — without making new editorial decisions.
Scope: Typographical errors, dropped and duplicated words and lines, punctuation and spacing slips, lost or altered formatting, comparison damage between the edited text and the formatted file, consistency with the existing style sheet, and front and back matter completeness. Not prose improvement (line-edit); not grammar or style change (copyedit); not structure (developmental-edit).
Definition of done: the author can hand the errata list to a typesetter and know exactly what to change, where to change it, and why — with every remaining judgment call separated into queries, and a second-pass collation confirming the corrections landed.
Read This Before Using the Skill
Reading for meaning is exactly what hides typos. A language model repairs teh, form/from, and a doubled the as it goes, because it reads intent, not letters. Treat this skill as a mechanically reliable proofreader — systematic pattern searches, source comparison, category-by-category sweeps — and not as a substitute for a human final reader.
Practical consequences:
- For the pass before publication, use a human proofreader if you can.
- If you can't, at minimum run this pass in a different session or a different model from the one that copyedited. A proofreader who shares the copyeditor's blind spots is not a fresh reader.
- Expect plausible-word errors to survive — a missing article, a wrong-but-grammatical preposition, a swapped homophone in an idiomatic phrase. Say so in the report rather than implying the text is clean.
Non-negotiables
- No new editorial decisions. The copyedit is finished. You correct; you do not improve.
- The style sheet is law. Every existing style decision stands, even the ones you would not have made. A change that contradicts it is a query, not a correction.
- Text must be frozen. Proofreading a file that is still being edited produces errata for text that no longer exists. Confirm the freeze, and re-proof anything that changed afterwards.
- Three buckets only: a mechanical correction, a query, or a re-edit request routed upstream. Nothing else.
- Never rewrite a sentence. If the prose is poor, that is not a typo — flag it for
line-editand move on. - Nothing is changed silently in the source. Corrections go to the errata list and the annotated proof.
- Work the text, not your memory of it. Do not skip a passage because a prior pass covered it.
Inputs
- The manuscript or formatted proof files
- Required: the
copyedit/style-sheet.md, andcopyedit/clean/orcopyedit/tracked/— the authoritative edited text - Optional:
line-edit/,editorial-review/,characters/*.md,MANUSCRIPT.md,ORDER.md,chapters.json, chapter properties (assets/templates/chapter-note.md) - Optional: the formatted artifact — EPUB, PDF, print interior, or the author's exported
.docx - Pass type: manuscript proof (default), proof against source, or final proof (collation)
- Medium: manuscript, ebook, or print
Chapter properties. If chapter files carry YAML front matter (template: assets/templates/chapter-note.md), read it as author intent, not prose: never number it as a paragraph or quote it as text. type and chapter override filename classification and ordering; canon: false excludes a chapter; revision_stage below copyedited means the file is not ready — stop. A property that contradicts the text is a query, not a correction. Unknown properties are ignored, and properties are never written back to the source.
Output Contract
<project_folder>/proofread/
├── metadata.md
├── status.json
├── errata.md
├── queries.md
├── checks.md
├── summary.md
└── proofs/
└── archive/Never invent a second layout.
errata.mdis the typesetter hand-off: numbered, located, and unambiguous.queries.mdholds anything requiring a decision, in the same format ascopyedit/queries.md.checks.mdrecords the document-level and production checks, pass or fail.proofs/receives the annotated proof copies.
Pass Types
| Pass | Compares | Catches | Run |
| Manuscript proof | Final text against the style sheet | Typos, dropped/duplicated words, punctuation, spacing, formatting slips | After copyedit |
| Proof against source | Formatted file against the edited manuscript | Conversion damage: lost text, broken markup, lost italics, wrong quote or dash characters, missing diacritics | After formatting |
| Final proof (collation) | Corrected proof against the errata list | Whether corrections landed, and what the corrections broke | After corrections |
The third pass is not optional in print or ebook work. Corrections introduce errors; if nobody checks them, the last pass is the one that made things worse.
Workflow
0. Pre-flight
- Verify the freeze. Compare the source last-modified times against the copyedit completion. If anything changed, say so and confirm before proceeding.
- Verify the gate. If
copyedit/queries.mdhas open queries, stop. Proofreading text that is about to change is wasted work. - Identify the pass type and medium.
- Load and read
copyedit/style-sheet.md— every answer you need about style is in it. - Report the manifest and confirm scope.
- Validate
ORDER.md/chapters.jsonif present (missing files, gaps, unlisted files). If both exist and disagree, ask which is authoritative.
1. Calibration
- Read the style sheet completely, including the Do Not Change list. That list is your protection against "correcting" the author's deliberate choices.
- Note what is not in the sheet. Anything the sheet does not settle is a query, not a decision.
- Identify the recurring search targets: character names, invented terms, place names, numerals conventions, dash and ellipsis style, quote style.
- Present your understanding of the conventions in a few lines and let the author correct you before you start.
2. Mechanical Sweep
Run the pattern checks in references/proofreading-checks.md. This is the part this skill does most reliably — exhaustive, systematic, and independent of whether you notice anything while reading.
Doubled words and punctuation, unbalanced quotation marks, mixed straight and curly quotes, double spaces, space before punctuation, missing space after punctuation, hyphen used where an en dash belongs, ellipsis inconsistency, stray [TK] and placeholders, chapter numbering sequence, repeated sentences and paragraphs.
Record every hit with a locator. These are almost always mechanical corrections.
3. Proof Against Source
Only when a formatted artifact exists. Compare it against the authoritative edited text, paragraph by paragraph, using references/conversion-errors.md.
This is the highest-value pass in the whole skill: text loss, scrambled paragraphs, dropped italics, missing diacritics, and substituted quote characters are invisible to a read-through but obvious in a comparison.
4. Read-Through Passes
Read the text with one category of error in mind per pass, not everything at once — the technique in references/reading-techniques.md. A pass for dropped words, a pass for punctuation, a pass for names and numbers.
Do not read for story. Do not stop to admire or fix prose. Every improvement that occurs to you goes in the re-edit requests, not into the errata.
5. Document and Production Checks
Work references/proofreading-checks.md: table of contents against actual chapter titles, chapter numbering, running heads and folios (print), chapter opener consistency, front matter, back matter, copyright page, ISBN, dedication, "also by" list, glossary cross-references, and ebook navigation, links, and metadata.
6. Collate and Report
- Write
errata.md— numbered corrections, located, with original and corrected text. - Write
queries.md— anything needing a decision. - Write
checks.md— each check passed, failed, or not applicable. - Write
summary.mdfromassets/templates/summary.md. - On a final proof pass, mark each errata item Landing / Not landing / Broke something else.
- Update
status.json.
Errata Classes
| Class | Meaning | Where |
| Correction | Unambiguous error, mechanical fix | errata.md |
| Query | Needs a decision; the sheet is silent or the intent is unclear | queries.md |
| Re-edit request | The prose needs rewriting, not correcting | errata.md as a flagged item, routed to line-edit |
| Non-issue | Checked and clear | checks.md |
An errata item that requires judgment is not an errata item. Move it.
Key References (load on demand)
| Need | File |
| Scope, pass types, freeze and gate rules, collation | references/proofreading-scope.md |
| Text, document, production, ebook, and print checklists | references/proofreading-checks.md |
| Comparing a formatted proof against the source | references/conversion-errors.md |
| How to actually catch typos: targeted passes, fresh eyes | references/reading-techniques.md |
Templates (copy, then fill)
Outputs — these belong in proofread/.
| Output | Template |
| metadata.md | assets/templates/metadata.md |
| status.json | assets/templates/status.json |
| errata.md | assets/templates/errata.md |
| queries.md | assets/templates/queries.md |
| checks.md | assets/templates/checks.md |
| summary.md | assets/templates/summary.md |
Author input files — these belong in the manuscript folder, alongside the chapter files. All are optional.
| File | Template |
| MANUSCRIPT.md | assets/templates/manuscript.md |
| ORDER.md | assets/templates/order.md |
| chapters.json | assets/templates/chapters.json |
| Chapter notes | assets/templates/chapter-note.md |
Edge Cases
- Open copyedit queries → stop; the text is not frozen
- No style sheet → do not invent one; query the conventions that matter, or run
copyeditfirst - Source changed after proofreading → the pass is void for the changed sections; re-proof them
- No formatted proof → run the manuscript pass only, and say what a proof-vs-source pass would add
- A deliberately unconventional convention (unquoted dialogue, intentional fragments, dialect) → protected; never "fix"
- Author asks you to fix prose while you're here → decline and route it upstream; mixed passes destroy the value of both
- Second proof missing page breaks or running heads → note as not applicable rather than passed
- Very long manuscript → work in blocks, but keep one errata list and number it continuously
- Repeated errors of one kind → one errata entry with a count and locators, not fifty entries
Working With the Other Skills
copyedit— runs immediately before this. Its style sheet is the authority for every decision, and itsclean/ortracked/output is the authoritative text you are checking. Nothing in this pass may contradict it.line-edit— prose work, two passes earlier. A sentence that reads poorly is not a typo; route it back rather than fixing it here.developmental-edit— structure, long before. Ifeditorial-review/carries open Critical notes, the text is nowhere near ready to proofread.character-interview— declared character facts and voice. Useful for name and fact consistency checks, and a source of terms for the search lists.
What This Skill Does Not Do
- Make new style or grammar decisions
- Improve prose, rhythm, or word choice
- Query or re-litigate what the style sheet has already settled
- Proofread text that is still being edited
- Guarantee a clean text — a machine read-through misses plausible-word errors, and the report says so
- Replace a human final reader before publication
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

