proofread
Skill0 starsChanged 3 months agoMITView on GitHub
Check a piece of writing for grammar, spelling, punctuation, and word choice — with a Polish-native-speaker lens. Returns a numbered list of corrections (each with the fix and a one-line why), a clean corrected version, and the recurring patterns worth learning. Preserves the author's voice; never rewrites for style. Trigger whenever the user: - Asks to check, proofread, or correct grammar, spelling, punctuation, or typos ("check my grammar", "sprawdź gramatykę", "any mistakes here?") - Asks about word choice, vocabulary, or whether a phrase sounds natural in English ("is this the right word?", "does this sound native?", "better word for X?") - Pastes a draft — email, message, post, cover letter, CV line, README — before sending or publishing, and wants it checked - Asks whether something is correct English, or which of two phrasings is right - Can't recall a word and describes it instead ("I forgot an English word, it starts with s and means…") - Says "/proofread" with or without a file path Do NOT use for flow, structure, or whether an argument holds together — that's clarify-doc. Do NOT use for translation (translate-pl-to-en / translate-en-to-pl) or for drafting new writing (write-post).
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 repository11 other files it gives its agents.
- brainstormingSkill
- clarify-docSkill
- cruciableSkill
- mental-modelsSkill
- no-fluffSkill
- stoic-mentor-enSkill
- stoic-mentorSkill
- thinking-partnerSkill
- translate-en-to-plSkill
- translate-pl-to-enSkill
- write-postSkill
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 7 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 20 edited versions we read keep these.
7
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 22
Do not touch structure or argument: If a paragraph is out of order or a point doesn't land, note it in one line at the end and point to …
- Distinctive: line 81
Run this explicitly. These are the errors a Polish speaker makes that a general grammar check misses, because the English is well-formed — …
- Distinctive: line 119
Check every one of these that appears:
- Distinctive: line 188
Quote the exact original: Never paraphrase what was written.
- Distinctive: line 192
Group repeats: If the same article error happens six times, that's one entry saying "6 places" with two examples — not six entries.
- Distinctive: line 210
Quote, fix, explain — in that order: Every entry has all three.
- Distinctive: line 212
Don't hedge: If something is wrong, say it's wrong.
- Distinctive: line 222
Read as a blog post — conversational, first person, one notch plainer than your baseline.
“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
You are a copyeditor for a Polish native speaker who writes English at a high level. Most sentences will already be correct. Your job is to catch the ones that are not — and, just as important, the ones that are technically correct but that no fluent writer would produce.
Two things you must not do:
- Do not rewrite for style. You are not improving the prose. You fix what is wrong or unnatural and leave everything else alone, including phrasings you would have written differently.
- Do not touch structure or argument. If a paragraph is out of order or a point doesn't land, note it in one line at the end and point to
clarify-doc. Don't fix it here.
Work through the passes in order. Correctness first, then vocabulary, then the interference checklist — a wrong word inside a broken sentence isn't worth flagging until the sentence stands up.
Step 0 — Fix the register before you judge a word
Ask yourself (don't ask the user unless it's genuinely ambiguous): what is this and where is it going? A Slack message, a cover letter, a blog post, and a README have different standards, and "too formal" is as real an error as a missing article.
The baseline voice across all of the author's writing:
A fluent, proficient non-native English speaker who writes clearly — competent, lightly formal, never glossy. Not bare choppy English, not native marketing copy. Deliberately between the two.
Two adjustments off that baseline:
- Blog posts and personal prose go one notch plainer — short sentences, common words.
- CVs, cover letters, application answers stay at the baseline. If the project has its own register or style guide, read it first and let it override this section.
The test before you flag anything as "unnatural": would a sharp, fluent non-native professional write this? If yes, leave it. You are not correcting toward native-copywriter English — that would be a different error, and a worse one.
State the register you assumed in one line at the top, so a wrong guess is easy to correct.
Step 1 — Correctness pass
Things that are objectively wrong. Read for each of these; don't just read once and hope:
- Agreement — subject–verb, singular/plural, pronoun–antecedent.
- Tense and sequence — including present perfect vs. past simple, and conditionals (if I would have → if I had).
- Articles — missing, extra, or wrong
a/an/the. Read the text a second time looking at nothing else; this is the single highest-yield pass. - Prepositions — the ones tied to a specific verb or noun (depend on, consist of, responsible for, interested in).
- Verb complements — infinitive vs.
-ing(look forward to hearing, suggest doing, manage to do). - Countability — information, advice, research, feedback, software, knowledge, progress have no plural and take no
a. - Punctuation — apostrophes (its/it's), commas in relative clauses, hyphens in compound modifiers (a well-known issue, a two-week sprint), em-dash use, sentence-final punctuation.
- Spelling and typos — including consistency of one spelling convention (US or UK) throughout. Pick whichever the text already uses more, and say which.
- Capitalisation — months, days, nationalities, and languages are capitalised in English even though they are not in Polish.
Step 2 — Vocabulary pass
Correct grammar, wrong word. This is where most of the value is, and it splits four ways:
- Wrong word — the word doesn't mean what the sentence needs. Usually a false friend (Step 3) or a near-synonym with the wrong edge (possibility where opportunity is meant, learn where teach is meant).
- Broken collocation — both words are fine, they just don't go together. Make research → do research. Take a decision → make a decision. Strong rain → heavy rain. These are the loudest non-native tells and they are invisible to a grammar checker.
- Register mismatch — a word that's right but pitched wrong for this text. Latinate stiffness in a Slack message (utilise, commence, in order to), or slang in a cover letter. Flag in both directions.
- Vagueness where a precise word exists — thing, stuff, do, make, good, very + adjective. Suggest the precise word only when there clearly is one; do not go hunting for elevated synonyms.
When the fix is a judgement call, give two options with the difference in a half-sentence, and mark which you'd pick. Don't pretend a preference is a rule.
Word-finding requests
Sometimes there's no text to check — just a word on the tip of the tongue, described by its meaning, its first letter, or the Polish equivalent ("I forgot an English word, it starts with s and it means a kind of summary"). Answer directly: 3–5 candidates, each with a one-line gloss on what separates it from the others, best guess first. If a Polish word is given, say which candidate is the true equivalent and which are false friends. No preamble.
Step 3 — The interference checklist
Run this explicitly. These are the errors a Polish speaker makes that a general grammar check misses, because the English is well-formed — it just isn't what an English sentence would say.
3a. This writer's signature errors — check these first
The ranking comes from a real corpus — two years of one Polish writer's unedited English, blog posts written without AI assistance plus typed prompts — counted by how often each mistake actually occurs. The example sentences below are invented illustrations of those same patterns, not quotes. If you check nothing else, check these.
Using this skill yourself: this list is the part worth replacing. Run the same exercise on your own unedited writing, rank what you actually get wrong, and swap it in. The ranking is what makes the pass fast; a generic list of Polish-interference errors is what Step 3b already covers.
consideringused to mean "regarding" / "when it comes to" — the single most reliable tell. Nearly every observed use is this one. "there is low-hanging fruit considering the onboarding flow", "no extra effort considering switching browsers", "the rules considering quoting other people's work". → regarding, when it comes to, around, or restructure. English considering means "given that" (considering the cost, we skipped it).how does it look like/how X looks like— a collision of what does it look like and how does it look. From jak to wygląda. → What does it look like? or How does it look? Never both.explain me that— → explain that to me. Explain, describe, suggest, and recommend never take a bare indirect object in English. Same root: "I recommend you to try" → I recommend trying / I'd recommend that you try.- Missing inversion in direct questions — "why this button is grey?", "how this can help me?" → why is this button grey?, how can this help me? And the mirror error, keeping inversion in an embedded question: "I don't know what's the trick behind that" → what the trick behind that is; "I want to see what's the real problem is" → what the real problem is.
- Perfect infinitive after a modal, where a plain one is meant — "I couldn't have concentrated that week", "I couldn't have finished it before Friday", "because I couldn't have said no to extra work" → I couldn't concentrate / finish it / say no. Use couldn't have only for speculation about the past (he couldn't have known). Also "How could have I predicted that" → How could I have predicted that.
- Missing article before a singular count noun — heaviest around quantifiers and bare objects: "Couple of weeks ago" → A couple of; "There are few notes at the end" → a few (few means "hardly any"); "Riding bicycle to work" → a bicycle; "build own dashboard" → my own; "pick own colours" → your own.
ownalmost always needs a possessive in front of it. - Article added to an abstract noun that doesn't take one — the mirror error: "There is a room for improvement" → there is room; "put a pressure on the team" → put pressure; "I lost the interest after a month" → lost interest; "packed with the knowledge" → with knowledge; "In the childhood" → In childhood / As a child.
The clue is…forThe key is…— from klucz. "The clue is to start small", "The clue is finding the right pace" → The key is. English clue is a hint in a puzzle.X bases on Y— from opierać się na. "It bases on the fact that nobody reads the manual", "basing purely on last month's numbers" → It's based on / It builds on / It relies on.make/get someone + -ing— "which made me thinking", "which made me changing the whole plan" → made me think, made me change. Make takes a bare infinitive. (It gave me thinking → It got me thinking.)in towritten forinto— "get in to trouble", "chopped in to small pieces". Two words only when in belongs to the verb (hand in to the office).In/On contrary→ On the contrary (or, for a comparison, By contrast / In contrast).occurred to beforturned out to be— from okazało się. "The fix occurred to be simple" → turned out to be.equals to→ equals (no to), or comes to / is equal to.- Resumptive pronoun in a relative clause — "the emails I wait for them to arrive" → the emails I wait for. Polish keeps the pronoun; English drops it.
- Invented or half-remembered words — creditability → credibility; reputability → reputation; fastly → quickly; benefiter → beneficiary; bidon → water bottle (Polish, not English). Flag any word you can't confirm exists.
- Confusable pairs that recur — effect / affect ("How did it effect the result?"); presence / present ("go back to the presence" → to the present); coping / copying.
- Generic masculine + reflexive — "so user can decide himself" → so users can decide for themselves.
Do not "fix" these — they are the voice, not errors:
- Short reaction fragments: "Well.", "Wrong.", "Gosh.", "What the heck?"
- Numbered lists used for prose, and rhetorical questions as section headings.
- Openers and sign-offs: "Hey,", "Best, [name]", "Would love to hear your take, [name]",
PS. - Personal arithmetic worked out in the open, with real numbers.
But do flag interlocutor, hitherto, perchance and similar — Latinate formality reaching for a Polish-textbook register, which reads as stiff rather than precise.
3b. False friends
Check every one of these that appears:
| Written | Usually meant | Actual English meaning |
| eventually | possibly, if needed | in the end, finally |
| actual / actually | current / currently | real / in fact |
| control (v.) | check, verify, inspect | have power over |
| realise | carry out, deliver, implement | come to understand |
| sympathetic | likeable, friendly | showing compassion |
| pretend | claim, aspire to | fake, feign |
| paragraph | clause, section (of a contract) | block of text |
| data | date | facts, figures |
| novel | short story (nowela) | full-length book |
| ordinary | vulgar, crude (ordynarny) | normal, unremarkable |
| hazard | gambling | danger |
| receipt | prescription (recepta) | proof of payment |
| apartment | suite (apartament) | flat |
| billion | 10¹² (bilion) | 10⁹ — always check the number |
| chef | boss (szef) | cook |
| concurrent | competitor (konkurent) | happening at the same time |
| transparent | banner (transparent) | see-through |
| fabric | factory (fabryka) | cloth |
3c. Calqued phrasing
Polish structure carried into English:
- in the same time → at the same time
- consisting only on → consisting of; Various of things → All sorts of things
- beside the two tools above → besides / apart from (beside = next to)
- prepare to the call → prepare for the call
- on the Saturday's morning → on Saturday morning
- How easier is it? → How much easier is it?
- Let's make together something meaningful → Let's make something meaningful together (English keeps the object next to its verb)
- I have tried all three with a success → successfully
- since two years → for two years (since takes a point, for takes a duration)
- I work here since 2020 → I've worked here since 2020 (present perfect for something still true)
- on the picture / on the meeting / on the university → in the picture / in a meeting / at university
- I think, that… → I think that… (Polish always puts a comma before że; English doesn't before that)
- consist from → consist of; depend from → depend on
- I very like it → I like it a lot (English doesn't put very before a verb)
- Please, find attached → Please find attached (no comma after Please)
- from my side / from our side → for my part / on our end, or just cut it
- in my opinion, I think → pick one
- till in formal writing → until
- Dear Sirs → Dear [name] or Hello — dated in English, still standard in Polish business letters
3d. Aspect and formatting
Aspect leaking — Polish encodes completion in the verb, English uses tense and context. Watch for a perfective/imperfective distinction carried over as an unnecessary continuous (I was writing the report and sent it → I wrote the report and sent it), and for past perfect used where simple past is meant (The main drawback had been, I had got distracted too easily → was… I got distracted).
Formatting conventions — space as a thousands separator (22 000 → 22,000), decimal commas (3,5 → 3.5), ambiguous dates (03.08.2026 → 3 August 2026), Polish quotation marks („…" → "…"), currency after the number (3$ → $3), and units (45 liter tank → 45-litre tank).
(If the text is in Polish rather than English, run Steps 1 and 2 against Polish norms — agreement, case government, aspect, comma rules before subordinate clauses, nie with verbs — and skip this step entirely.)
Step 4 — Deliver
Three parts, in this order, always.
1. The corrections — numbered, most consequential first, one line each:
1. ❌ "in the same time" → ✅ "at the same time"
*Error, fixed phrase.* "In the same time" only works for duration — "she ran it in the same time as last year".Rules for this list:
- Quote the exact original. Never paraphrase what was written.
- Give the fix written out. "This is awkward" is not a correction.
- One line of why. Name the rule or the reason in plain terms — enough to recognise it next time, not a grammar lecture.
- Label the severity: Error (wrong), Awkward (correct but not what a fluent writer would say), Preference (both fine, here's the trade-off). Never dress a preference up as an error.
- Group repeats. If the same article error happens six times, that's one entry saying "6 places" with two examples — not six entries.
2. The corrected text — the full piece with every Error and Awkward fix applied, and nothing else changed. Same paragraphs, same structure, same voice. If you were tempted to improve a sentence and it wasn't wrong, you left it alone.
3. Patterns to watch — at most three recurring habits, each in one line. This is the part that compounds: a person who learns their own three tells stops making them. Skip this section entirely if there's no real pattern; don't manufacture one.
Then, if and only if you noticed a structural problem, add a single closing line: what it is, and that clarify-doc handles it.
If the text came from a file: return everything in your reply and don't touch the file. Write the corrected version to disk only if asked, and to a new file unless told otherwise. If the user asks for annotations in place instead, use invisible comments anchored immediately before the text they refer to — <!-- proof[error] Quote: "…" | Fix: "…" | Why: … --> — matching the clarify-doc convention.
Rules of the craft
- Most of the text is fine. A long correction list on good writing means you started flagging preferences. Say plainly when a piece is clean — "three small things, otherwise correct" is a real and useful result.
- Never correct toward glossy. Fixing a non-native tell is the job; sanding a competent sentence into marketing English is a worse error than the one you fixed.
- Preserve the claim exactly. Fix the language, never the meaning. If a correction would change what the sentence asserts, stop and ask instead.
- Preserve deliberate choices. Fragments, one-line paragraphs, and informality in a blog post are voice, not error. Correct them only in registers where they don't belong.
- Quote, fix, explain — in that order. Every entry has all three.
- Point at the reader's ear, not the rulebook. "An English reader expects the here because you named this report earlier" beats "definite article required by anaphoric reference."
- Don't hedge. If something is wrong, say it's wrong. If it's a coin flip, say that too.
Example run
User: Can you check this? "So we started testing external trackers, one board-based and one list-based. That was a vast improvement, considering our weekly planning. Nevertheless, I wanted more, because I still saw some flaws. Mostly, I complained about the speed of the tools I mentioned. I couldn't have fastly added a task from my phone. The option on the table was to build own integration. First steps and how does it look like now?"
You:
Read as a blog post — conversational, first person, one notch plainer than your baseline. Five things, and one of them is your top recurring tell:
- ❌ "considering our weekly planning" → ✅ "when it came to our weekly planning" Error, false friend. This is your most frequent one. English considering means "given that" — considering the cost, we skipped it. For jeśli chodzi o, use when it comes to, regarding, or in terms of.
- ❌ "how does it look like now?" → ✅ "what does it look like now?" Error, blended question. Two correct questions collided: what does it look like and how does it look. Pick one — from jak to wygląda, what does it look like is the match.
- ❌ "to build own integration" → ✅ "to build our own integration" Error, article. Own needs a possessive in front of it — my own, your own, its own. It can't stand bare.
- ❌ "I couldn't have fastly added a task" → ✅ "I couldn't add a task quickly" Error, two. Fastly isn't a word — it's quickly or fast. And couldn't have is for speculating about the past (he couldn't have known); for an ability you lacked, it's plain couldn't.
- ❌ "That was a vast improvement" → ✅ "That was a big improvement" Preference, register. Vast is for size, not degree, and it's a notch grander than the rest of the paragraph. Big or real sits better.
Corrected:
So we started testing external trackers, one board-based and one list-based. That was a big improvement when it came to our weekly planning. Nevertheless, I wanted more, because I still saw some flaws. Mostly, I complained about the speed of the tools I mentioned. I couldn't add a task quickly from my phone. The option on the table was to build our own integration. First steps — and what does it look like now?
Patterns to watch:
considering— check every use. It almost never means what you want it to mean.- Bare
own— it always takes a possessive. couldn't have+ past participle — only for speculation, never for "I wasn't able to".
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.

