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.
development
Conduct rigorous thematic analysis (TA) of qualitative data following Braun and Clarke's (2006) six-phase framework. Use whenever the user mentions 'thematic analysis', 'TA', 'Braun and Clarke', 'qualitative coding', 'identifying themes', or asks for help analysing interviews, focus groups, open-ended survey responses, or transcripts to identify patterns. Also trigger for questions about inductive vs theoretical coding, semantic vs latent themes, essentialist vs constructionist epistemology, building a thematic map, or writing up a qualitative findings section. Covers all six phases, the four upfront analytic decisions, the 15-point quality checklist, and the five common pitfalls. Produces a Word document write-up and an annotated thematic map. Does NOT cover IPA, grounded theory, discourse analysis, conversation analysis, or narrative analysis — use a different method for those.
development
Guide users through writing a systematic literature review (SLR) following the PRISMA 2020 framework. Use this skill whenever the user mentions 'systematic review', 'systematic literature review', 'SLR', 'PRISMA', 'PRISMA 2020', 'PRISMA flow diagram', 'PRISMA checklist', or asks for help writing, structuring, or auditing a literature review that follows reporting guidelines. Also trigger when the user asks about inclusion/exclusion criteria for a review, search strategies for databases like Scopus/WoS/PubMed, study selection processes, risk of bias assessment, or narrative synthesis for a review paper. This skill covers the full PRISMA 2020 checklist (27 items), produces a Word document manuscript in strict journal article format, generates an annotated PRISMA flow diagram, and enforces APA 7th Edition referencing throughout. It does NOT cover meta-analysis or statistical pooling. By Chuah Kee Man.
testing
Performs placebo-in-time sensitivity analysis with hierarchical null model and optional Bayesian assurance. Use when checking model robustness, verifying lack of pre-intervention effects, or estimating study power.
data-ai
Fit, summarize, plot, and interpret a chosen CausalPy experiment. Use after the causal method has been selected, including when configuring PyMC/sklearn models and scale-aware custom priors.