skills/47-conorbronsdon-avoid-ai-writing/SKILL.md
Audit and rewrite content to remove AI writing patterns ("AI-isms"). Use this skill when asked to "remove AI-isms," "clean up AI writing," "edit writing for AI patterns," "audit writing for AI tells," or "make this sound less like AI." Supports a detection-only mode that flags patterns without rewriting.
npx skillsauth add brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research avoid-ai-writingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are editing content to remove AI writing patterns ("AI-isms") that make text sound machine-generated.
This skill operates in one of two modes:
rewrite (default) — Flag AI-isms and rewrite the text to fix them.
detect — Flag AI-isms only. No rewriting. Use this mode when:
Trigger detect mode when the user says "detect," "flag only," "audit only," "just flag," "scan," "what AI patterns are in this," or similar. Default to rewrite mode if not specified.
In rewrite mode, your job is to:
In detect mode, your job is to:
## 🚀 What This Means. Exception: social posts may use one or two emoji sparingly — at the end of a line, never mid-sentence.genuine, real (as in "a real improvement"), truly, quite frankly, to be honest, let's be clear, it's worth noting that. Just state the fact.worth reading, worth paying attention to, worth a look, worth exploring, worth checking out, worth your time. These substitute a generic thumbs-up for a specific reason. Say why something matters instead.perhaps, could potentially, it's important to note that, to be clear. Make the point directly.Words are organized into three tiers based on how reliably they signal AI-generated text. This tiered approach — adapted from brandonwise/humanizer's vocabulary research — reduces false positives on words that are fine in isolation but suspicious in clusters.
| Replace | With | |---|---| | delve / delve into | explore, dig into, look at | | landscape (metaphor) | field, space, industry, world | | tapestry | (describe the actual complexity) | | realm | area, field, domain | | paradigm | model, approach, framework | | embark | start, begin | | beacon | (rewrite entirely) | | testament to | shows, proves, demonstrates | | robust | strong, reliable, solid | | comprehensive | thorough, complete, full | | cutting-edge | latest, newest, advanced | | leverage (verb) | use | | pivotal | important, key, critical | | underscores | highlights, shows | | meticulous / meticulously | careful, detailed, precise | | seamless / seamlessly | smooth, easy, without friction | | game-changer / game-changing | describe what specifically changed and why it matters | | hit differently / hits different | (say what specifically changed, or cut) | | utilize | use | | watershed moment | turning point, shift (or describe what changed) | | marking a pivotal moment | (state what happened) | | the future looks bright | (cut — say something specific or nothing) | | only time will tell | (cut — say something specific or nothing) | | nestled | is located, sits, is in | | vibrant | (describe what makes it active, or cut) | | thriving | growing, active (or cite a number) | | despite challenges… continues to thrive | (name the challenge and the response, or cut) | | showcasing | showing, demonstrating (or cut the clause) | | deep dive / dive into | look at, examine, explore | | unpack / unpacking | explain, break down, walk through | | bustling | busy, active (or cite what makes it busy) | | intricate / intricacies | complex, detailed (or name the specific complexity) | | complexities | (name the actual complexities, or use "problems" / "details") | | ever-evolving | changing, growing (or describe how) | | enduring | lasting, long-running (or cite how long) | | daunting | hard, difficult, challenging | | holistic / holistically | complete, full, whole (or describe what's included) | | actionable | practical, useful, concrete | | impactful | effective, significant (or describe the impact) | | learnings | lessons, findings, takeaways | | thought leader / thought leadership | expert, authority (or describe their actual contribution) | | best practices | what works, proven methods, standard approach | | at its core | (cut — just state the thing) | | synergy / synergies | (describe the actual combined effect) | | interplay | relationship, connection, interaction | | in order to | to | | due to the fact that | because | | serves as | is | | features (verb) | has, includes | | boasts | has | | presents (inflated) | is, shows, gives | | commence | start, begin | | ascertain | find out, determine, learn | | endeavor | effort, attempt, try | | keen (as intensifier) | interested, eager, enthusiastic (or cut — just state the interest) | | symphony (metaphor) | (describe the actual coordination or combination) | | embrace (metaphor) | adopt, accept, use, switch to |
These words are legitimate on their own. When two or more show up together, the paragraph likely needs a rewrite.
| Replace | With | |---|---| | harness | use, take advantage of | | navigate / navigating | work through, handle, deal with | | foster | encourage, support, build | | elevate | improve, raise, strengthen | | unleash | release, enable, unlock | | streamline | simplify, speed up | | empower | enable, let, allow | | bolster | support, strengthen, back up | | spearhead | lead, drive, run | | resonate / resonates with | connect with, appeal to, matter to | | revolutionize | change, transform, reshape (or describe what changed) | | facilitate / facilitates | enable, help, allow, run | | underpin | support, form the basis of | | nuanced | specific, subtle, detailed (or name the actual nuance) | | crucial | important, key, necessary | | multifaceted | (describe the actual facets, or cut) | | ecosystem (metaphor) | system, community, network, market | | myriad | many, numerous (or give a number) | | plethora | many, a lot of (or give a number) | | encompass | include, cover, span | | catalyze | start, trigger, accelerate | | reimagine | rethink, redesign, rebuild | | galvanize | motivate, rally, push | | augment | add to, expand, supplement | | cultivate | build, develop, grow | | illuminate | clarify, explain, show | | elucidate | explain, clarify, spell out | | juxtapose | compare, contrast, set side by side | | paradigm-shifting | (describe what actually shifted) | | transformative / transformation | (describe what changed and how) | | cornerstone | foundation, basis, key part | | paramount | most important, top priority | | poised (to) | ready, set, about to | | burgeoning | growing, emerging (or cite a number) | | nascent | new, early-stage, emerging | | quintessential | typical, classic, defining | | overarching | main, central, broad | | underpinning / underpinnings | basis, foundation, what supports |
These are normal words. Only flag them when the text is saturated with them — a sign that AI filled space with vague praise instead of specifics.
| Word | What to do | |---|---| | significant / significantly | Replace some with specifics: numbers, comparisons, examples | | innovative / innovation | Describe what's actually new | | effective / effectively | Say how or cite a metric | | dynamic / dynamics | Name the actual forces or changes | | scalable / scalability | Describe what scales and to what | | compelling | Say why it compels | | unprecedented | Name the precedent it breaks (or cut) | | exceptional / exceptionally | Cite what makes it an exception | | remarkable / remarkably | Say what's worth remarking on | | sophisticated | Describe the sophistication | | instrumental | Say what role it played | | world-class / state-of-the-art / best-in-class | Cite a benchmark or comparison |
These slot-fill constructions signal that a sentence was generated, not written. If a phrase has a blank where a noun or adjective could go and still sound the same, it's too generic.
These aren't individual word or phrase problems — they're patterns in how the text flows as a whole. AI text is metronomic; human text has varied rhythm.
Structure is the #1 detection signal. AI detection tools (including Pangram, which trains a classifier on 28M human documents) weight structural regularity higher than vocabulary. Consistent sentence construction, uniform pacing, and symmetrical phrasing patterns are harder to mask than swapping out a few flagged words. If you fix every word on the Tier 1 list but leave the rhythm untouched, the text still reads as AI-generated.
If the text has 5+ flagged vocabulary hits across multiple categories, 3+ distinct pattern categories triggered, and uniform sentence/paragraph length, patching individual phrases won't fix it — the structure itself is AI-generated. Advise a full rewrite: state the core point in one sentence, then rebuild from there.
Not all AI-isms are equal. When doing a quick pass or triaging a large document, prioritize by tier:
Use P0+P1 for quick passes. Full audit covers all three tiers.
When writing about AI writing patterns (blog posts, tutorials, skill documentation like this file), quoted examples are exempt from flagging. Text inside quotation marks, code blocks, or explicitly marked as illustrative ("for example, AI might write...") should not be rewritten. Only flag patterns that appear in the author's own prose, not in cited examples of bad writing.
Pass an optional context hint to adjust rule strictness. If no context is specified, auto-detect from content cues (short + hashtags = social, code blocks = technical, salutation = email, default = blog).
linkedin � Short-form social. Punchy fragments, visual formatting matter.
blog � Default. Standard long-form prose. All rules apply at full strength.
technical-blog � Long-form with code, architecture, APIs. Technical terms get a pass.
investor-email � High-trust audience. Tighten everything; promotional language is the biggest risk.
docs � Documentation, READMEs, guides. Clarity over voice.
casual � Slack messages, internal notes, quick replies. Only catch the worst offenders.
Rules not listed in the table apply at full strength across all profiles.
| Rule | linkedin | blog | technical-blog | investor-email | docs | casual | |------|----------|------|----------------|----------------|------|--------| | Em dashes | relaxed (2/post OK) | strict | strict | strict | relaxed | skip | | Bold overuse | relaxed (bold hooks OK) | strict | strict | strict | relaxed | skip | | Emoji in headers | relaxed (1-2 end-of-line OK) | strict | strict | strict | skip | skip | | Excessive bullets | skip (lists work on LinkedIn) | strict | relaxed (technical lists OK) | strict | skip (lists are docs) | skip | | Hedging | strict | strict | relaxed ("may" is accurate in technical) | strict | relaxed | skip | | Word table (full list) | strict | strict | partial (see below) | strict | relaxed | P0 only | | Promotional language | relaxed (some sell is expected) | strict | strict | extra strict | strict | skip | | Significance inflation | strict | strict | strict | extra strict | relaxed | skip | | Copula avoidance | skip | strict | relaxed | strict | skip | skip | | Uniform paragraph length | skip (short-form) | strict | strict | strict | relaxed | skip | | Numbered list inflation | relaxed | strict | relaxed | strict | skip | skip | | Rhetorical questions | relaxed (1 as hook OK) | strict | strict | strict | strict | skip | | Transition phrases | skip (short-form) | strict | strict | strict | relaxed | skip | | Generic conclusions | skip | strict | strict | extra strict | skip | skip |
Technical-blog word table exceptions: These terms have legitimate technical meaning and should not be flagged in technical context: robust, comprehensive, seamless, ecosystem, leverage (when discussing actual platform leverage/APIs), facilitate, underpin, streamline. Still flag: delve, tapestry, beacon, embark, testament to, game-changer, harness.
"Extra strict" means: flag even borderline instances. In investor emails, a single "thriving ecosystem" can undermine the whole message.
"Skip" means: don't audit this category for this profile. The rule doesn't apply or isn't worth the edit.
When no context is specified, infer from these signals:
| Signal | Inferred context |
|--------|-----------------|
| Under 300 words + hashtags or mentions | linkedin |
| Code blocks, API references, or technical architecture | technical-blog |
| Salutation ("Hi [name]", "Dear") + investor/fundraising language | investor-email |
| Step-by-step instructions, parameter docs, README structure | docs |
| No strong signals | blog (safest default � all rules apply) |
If auto-detection feels wrong, say which profile you're using and why. The user can override.
Return your response in four sections:
1. Issues found A bulleted list of every AI-ism identified, with the offending text quoted.
2. Rewritten version The full rewritten content. Preserve the original structure, intent, and all specific technical details. Only change what the guidelines require.
3. What changed A brief summary of the major edits made. Not every word, just the meaningful changes.
4. Second-pass audit Re-read the rewritten version from section 2. Identify any remaining AI tells that survived the first pass — recycled transitions, lingering inflation, copula avoidance, filler phrases, or anything else from the categories above. Fix them, return the corrected text inline, and note what changed in this pass. If the rewrite is clean, say so.
Return your response in two sections:
1. Issues found A bulleted list of every AI-ism identified, with the offending text quoted. Group by severity (P0, P1, P2).
2. Assessment For each flag, note whether it's a clear problem or a judgment call. Some AI-associated patterns are effective writing techniques — uniform paragraph length is a problem, but a well-placed "however" isn't. Call out which flags the writer should definitely fix vs. which ones are worth a second look but might be fine in context. If the text is clean, say so.
The goal is writing that sounds like a person wrote it. Direct. Specific. The writing should demonstrate confidence, not assert it.
Five principles for human-sounding rewrites:
If the original writing is already strong, say so and make only the necessary cuts. Don't over-edit for the sake of it.
The replacement table provides defaults, not mandates. If a flagged word is clearly the right choice in context, preserve it.
tools
Recommend AND run open-source AI tools, agents, Claude Code / Codex skills, and MCP servers for any stage of a literature review — searching, reading, extracting, synthesizing, screening, citation-checking, and paper writing. Use when the user asks "what tool should I use to..." OR "install/run/use <tool> to ..." for research/lit-review work: automating a survey or related-work section, PDF→Markdown extraction for LLMs (MinerU/marker/docling), PRISMA / systematic review (ASReview), citation-backed Q&A over PDFs (PaperQA2), wiring papers into Claude/Cursor via MCP (arxiv/paper-search/zotero servers), or chatting with a Zotero library. Ships a launcher (scripts/litrun.py) that installs each tool in an isolated venv and runs it. Curated catalog of 70+ vetted projects. 支持中英文(用于「文献综述工具选型」与「一键安装/运行」)。
development
Route empirical-research requests through the Auto-Empirical Research Skills catalog when this whole repository is installed as one skill in Codex, CodeBuddy, Claude Code, or another IDE. Use to choose and load the right vendored AERS skill for causal inference, econometrics, replication, data acquisition, manuscript writing, peer review and referee responses, citation checking, de-AIGC editing, or full empirical-paper workflows without reading the entire repository at once.
documentation
Use when the project collects primary data or runs a field, lab, or survey experiment, before the intervention begins — write the pre-analysis plan, size the sample from a power calculation, and register with the AEA RCT Registry. Apply after the design is chosen in aer-identification and before any outcome data are seen.
tools
Guide economists to authoritative data sources with explicit, confirmed data specifications before retrieval; interfaces with Playwright MCP to navigate portals and extract real data, not articles about data.