ai-writing-qa
Skill4 starsChanged 5 months agoMITView on GitHub
Scrubs scripts and copy for AI tells before they ship, then hands back a clean rewrite in your voice. Catches the giveaways that make writing sound like ChatGPT or Claude - em dashes, blacklisted buzzwords, "not X it's Y" contrasts, tricolons, warmup, hedging, dated short-form hooks. Auto-detects register (client-facing / internal / creative) and applies that voice. Trigger on "/ai-writing-qa", "scrub this", "de-slop this", "does this sound like AI", "QA this script", "QA this copy", "check this for AI tells", "make this sound human", or when you paste a script, caption, email, or piece of copy and want it cleaned before it ships. On-demand only, never auto-fires, never sends, never saves.
In this repository17 other files it gives its agents.
- build-captureSkill
- build-modeSkill
- fitfoSkill
- flow-mapSkill
- generate-system-mapSkill
- imessageSkill
- leanSkill
- meta-promptSkill
- no-bullshitSkill
- plain-englishSkill
- pressure-testSkill
- problem-logSkill
- reality-checkSkill
- swipeSkill
- video-breakdownSkill
- viral-hook-creatorSkill
- working-with-claudeSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 8 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
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
- Distinctive: line 16
Step 1 - Detect the register: Read the copy and decide which voice applies:
- Distinctive: line 22
If register is ambiguous, default to creative.
- Distinctive: line 39
Client comms only: no slang, no abbreviations, no em dashes, gratitude first, single call to action.
- Distinctive: line 82
Low burstiness: every sentence 15-20 words, same subject-verb-object shape.
- Distinctive: line 89
Sanitized grammar: never starts a sentence with "But" or "And," never uses fragments.
- Distinctive: line 116
Pub test: read it aloud. Would you say it to a colleague over a beer?
- Distinctive: line 123
Clean version only: No per-line annotation breakdown by default.
- Very specific: line 126
If nothing trips: say Clean.
- Distinctive: line 127
If you want the before/after breakdown for a run, ask.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
AI Writing QA
Purpose
Catch AI giveaways in scripts and copy before they ship, so nothing you put out reads like a bot wrote it. Paste anything. This scans it against a fixed catalog of tells, rewrites every line that trips one, and hands back a clean version in your voice. Output is a draft. It never sends and never saves.
Execution logic
Step 1 - Detect the register. Read the copy and decide which voice applies:
- Client-facing (email or anything a customer reads): strict. Gratitude first, one clear call to action, no slang, no abbreviations, no em dashes, warm but contained. Hyperlink with anchor text, never raw URLs.
- Internal (teammates, DMs, notes): casual and fast. Abbreviations fine, bullet points fine. Still no em dashes, still no slop.
- Creative (scripts, captions, social, marketing): hook fast, spoken and human, take a position. Still no em dashes, still no slop.
If register is ambiguous, default to creative. If it looks like a client email, say so before rewriting.
Step 2 - Scan every line against all six buckets below plus the two fast tests.
Step 3 - Rewrite each tripped line. Swap blacklisted words for a concrete noun or active verb. Kill the structural tells. Apply the register's voice. Run the pub test and the first-10% test on the result.
Step 4 - Output the clean version only. Lead with one line: the tell count (e.g. 9 tells caught). Then the full rewritten copy. No per-line breakdown unless asked. If nothing trips, say so and return the text unchanged. Never send. Never save.
Bucket 1 - Core rules (non-negotiable)
- No em dashes. Ever. Single biggest Claude/ChatGPT tell. Use periods, commas, or rewrite.
- No AI slop: filler, buzzwords, hollow sentences that sound professional but say nothing.
- No LinkedIn-energy prose: inspirational throat-clearing, fake profundity, "thought leader" voice.
- No warmup: "great question," restating the prompt, "let's dive in," "in this video we'll explore."
- No hedging / disclaimers: "it's worth noting," "it's important to consider," "that said," watered-down both-sides takes.
- Client comms only: no slang, no abbreviations, no em dashes, gratitude first, single call to action.
Bucket 2 - Blacklisted words (kill list)
Replace every one with a concrete noun or active verb.
- Verbs: delve, leverage, foster, ignite, empower, unleash, unlock, harness, underscore, illuminate, facilitate, bolster, optimize, streamline, elevate, supercharge, revolutionize, demystify, navigate.
- Adjectives: seamless, robust, cutting-edge, state-of-the-art, multifaceted, pivotal, dynamic, future-ready, comprehensive, unwavering, transformative, game-changing.
- Nouns / metaphors: tapestry, landscape, realm, beacon, symphony, journey, roadmap, ecosystem, treasure trove, plethora, myriad, testament, wealth (of).
- Quantity fluff: a myriad of, a plethora of, a wealth of, a host of.
Quick swaps:
| Slop | Use instead |
| leverage | use |
| empower | help |
| optimize | cut / speed up |
| seamless | (describe the actual feature) |
| myriad | many |
| testament to | proof of |
Bucket 3 - Phrase tells
- Openers: "In today's fast-paced/digital world," "In the ever-evolving landscape of," "At its core," "Imagine a world where," "Picture this," "Did you know," "Let's dive in," "Let's break this down."
- Fake-empathy openers: "As a [business owner/creator], you know…," "We've all been there," "Picture this…" followed by a generic problem.
- Transitions / hooks: "But here's the kicker," "Here's the thing," "That's only half the story," "Why does this matter?," "Real talk," "Here's the truth," "Let's be honest," "Plot twist," "But it gets better," "The best part?," "Here's where it gets interesting."
- Connector words AI overuses: furthermore, moreover, additionally, in essence.
- Closers: "In conclusion," "At the end of the day," "Ultimately," "In essence," "The bottom line," forward-looking aspirational wrap-ups.
- Hedges: "it's worth noting," "it's important to note/consider," "while it's true," "it could be argued," "generally speaking," "aims to."
Bucket 4 - Structural tells (the hard ones to catch)
These pass spellcheck and still scream AI. Watch the rhythm, not just the words.
- "Not X, it's Y" / false contrast: "It's not about the camera, it's about the story." "This isn't X. It's Y." AI's favorite move. Kill on sight unless genuinely earned once.
- Tricolon / rule of three: the three-part list is one of the most obvious tells. "No hardware. No fees. Just growth." "Faster, simpler, smarter." "It's clean, it's fast, it's reliable." Fine once per piece if genuinely earned, robotic the moment it's the default rhythm. Watch both forms: the punchy fragment triad ("X. Y. Z.") and the in-sentence adjective triad ("a fast, simple, and powerful tool"). When you spot one, cut to two items or one specific claim.
- Low burstiness: every sentence 15-20 words, same subject-verb-object shape. Reads like a perfect rectangle. Fix with high-low: long explanatory sentence, then a short punch.
- Rhetorical question then immediate answer: "The result? Massive growth." "Why does this work? Simple."
- "From X to Y" sweeping range: "From startups to enterprises," "From beginners to pros."
- Listicle formatting: Bold header: followed by one explanatory sentence, repeated identically down the page.
- "More than just…": "It's more than just an app."
- Telling-what-it-represents: "This represents/reflects/underscores/signals a shift." Just state the fact.
- Over-symmetry: parallel paragraph openers, every point the same length and cadence.
- Sanitized grammar: never starts a sentence with "But" or "And," never uses fragments. Real voice is messier.
Bucket 5 - Claude-specific tells (2026)
- Em dashes at high frequency (the signature).
- "You're absolutely right" plus agreement, in chat/edit contexts.
- "Here's…" framing: "Here's how," "Here's what," "Here's the breakdown."
- "Let me break this down," "a few things to consider," "key takeaways."
- Over-helpful, over-balanced, allergic to a strong stance (RLHF politeness). For scripts this kills the hook. Take the position.
- Headers and bullets where prose belongs.
Bucket 6 - Short-form script tells (overused, now dated)
Worked in 2023-24, now read as AI/template:
- "Stop scrolling," "You won't believe this," "Did you know this trick," "POV:," "Nobody talks about this," "This changed everything," "Save this for later."
- Standardized hook-value-CTA with visible connective tissue ("and the best part?," "here's why that matters").
- Over-edited transitions/effects. 2026 favors minimalist cuts, retention over flash, authenticity over production polish.
The 2 fastest QA tests
- Pub test: read it aloud. Would you say it to a colleague over a beer? If not, rewrite.
- First-10% delete: the real opening is almost always the second sentence. Cut the throat-clearing and start at the conflict.
Output format
- Clean version only. No per-line annotation breakdown by default.
- Lead with one line: the tell count, e.g.
9 tells caught. Clean version below. - Then the full rewritten copy in the detected register's voice.
- If nothing trips: say
Clean. Nothing tripped.and return the text unchanged. Don't rewrite for its own sake. - If you want the before/after breakdown for a run, ask. It gives it inline then.
- Draft only. Never send, never save anywhere.
Sources
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.

