· Audit prose for AI tells in docs, PRs, emails, slides, docstrings. Triggers: 'ai writing', 'sounds like chatgpt', 'ai slop prose', 'llm voice', 'sound human'. Not for code (use anti-slop).
التثبيت
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
· Audit prose for AI tells in docs, PRs, emails, slides, docstrings. Triggers: 'ai writing', 'sounds like chatgpt', 'ai slop prose', 'llm voice', 'sound human'. Not for code (use anti-slop).
Anti-AI-Prose: Audit Writing for Machine-Generated Patterns
Detect and fix the linguistic tells that make written English read as machine-generated. The goal is prose that sounds like a specific, thoughtful human wrote it.
This skill applies to any text: documentation, READMEs, wikis (Confluence, Notion, internal), pull request descriptions, commit messages, release notes, blog posts, emails, slide copy, creative writing, and code comments / docstrings. The vocabulary, syntax, tone, and formatting checks are language-domain, not platform-domain.
Based in part on Wikipedia: Signs of AI writing - a field guide compiled by editors who have read enormous volumes of LLM-generated text and know what it actually looks like - and on stop-slop (MIT), which contributed the confident-filler check: emphasis crutches, rhetorical setups, and the faux-profundity fragment.
When to use
Auditing a README, doc page, or wiki article that feels machine-written
Reviewing a PR body, commit message, or release note draft before publishing
Polishing a blog post, email, or presentation script you wrote with LLM help
Checking creative writing (fiction, essays) for AI tells after an LLM-assisted pass
Reviewing docstrings and code comments for the same prose patterns
Any time someone says "this sounds like ChatGPT wrote it"
Self-check after a heavy LLM-drafting session
When NOT to use
Code quality, over-abstraction, dependency creep, stale idioms - use anti-slop
Doc drift after a feature change, API rename, or config update - use update-docs
Generating or restructuring a prompt from rough notes - use prompt-generator
Correctness bugs, logic errors, edge cases - use code-review
Security review of auth, secrets, or attack surface - use security-audit
Full multi-dimensional repo audit - use full-review
AI Self-Check
Before returning any audit, verify:
Findings are patterns, not taste: the issue is a demonstrable AI tell (from the Wikipedia guide or observed LLM output), not personal writing preference
Context respected: academic and technical prose can look formal without being AI-generated. Journalism, marketing, and tourism writing have legitimate conventions that overlap with AI tells. Do not flag genre conventions as AI tells
Direct quotes preserved: do not edit quoted material from other authors, even if it contains banned vocabulary
Domain terms kept: pivotal in hinge hardware specs, landscape in horticulture, foster as a verb in child welfare, realm in fantasy fiction - these are not tells in context
Code blocks untouched: do not flag identifiers, strings, or code comments that contain banned words as part of functional code
Rewrites are real improvements: every "after" is shorter, clearer, or more specific than the "before". No lateral rewrites that just swap synonyms
Severity is honest: do not inflate P3 findings to P2 to pad the report
Density and short-text rule applied: density heuristic applied before assigning severity; for text under 100 words, 2+ tells in one paragraph = P1 regardless of per-500-word threshold
Audit output itself uses no AI-prose tells (apply these rules to your own output)
AI fallback names checked (fiction): protagonist and major-character names compared against the documented fallback set (Elara, Lyra, Aurora, Kael, Vale, Cassius, etc.) and the phonetic tell (2 soft syllables, A/L/R/N consonants, no demographic anchor); fallback-set names allowed only when the setting and population organically produce them
Current source checked: dated versions, CLI flags, API names, and support windows are verified against primary docs before repeating them
Hidden state identified: local config, credentials, caches, contexts, branches, cluster targets, or previous runs are made explicit before acting
Verification is real: final checks exercise the actual runtime, parser, service, or integration point instead of only linting prose or happy paths
Routing overlap checked: overlapping skills, trigger terms, and "When NOT to use" boundaries are checked before returning guidance
Spec claims verified: claims about tool behavior, output contracts, or repo conventions are checked against current docs, scripts, or skill files
Adverb stacking checked: -ly adverb density scanned; passages with multiple adverb-modified speech tags or adjacent adverb clusters flagged at the same density threshold as vocabulary tells
Confident filler checked: emphasis crutches, rhetorical setups, and faux-profundity fragments flagged by pattern/density, not on isolated earned uses
Overflagging avoided: plain but valid technical prose is not labeled AI-written without concrete evidence
Audience preserved: edits keep the author's domain vocabulary, intent, and required formality
Performance
Review a representative sample first, then expand only if the same pattern repeats across the document.
Group repeated prose issues by pattern instead of leaving near-duplicate comments on every paragraph.
Prioritize high-visibility text: titles, summaries, intros, conclusions, and user-facing docs.
Best Practices
Flag exact phrases and structural patterns, not vibes.
Offer replacement copy when the fix is obvious; otherwise describe the problem and let the author decide.
Do not erase necessary caveats, compliance language, or domain-specific precision to make prose sound casual.
Workflow
Step 1: Scope the audit
Default scope based on context:
If invoked on a specific file or paste - audit that text
If invoked with no target and there are uncommitted changes to .md / .txt / doc files - audit those
If invoked in a code repo with recent commits - audit the docstrings and comments in changed files
Otherwise - ask the user for a target
Available scopes:
Single file - one doc, README, draft, or source file
Directory - all .md / .rst / .txt under a path
Pasted text - inline block the user supplies
Recent changes - git diff against a base
Comments and docstrings only - scan code files but audit only prose regions
Step 2: Detect text kind
Different text types have different conventions. Before flagging, identify which applies:
Technical docs - formal is OK, but vocabulary bans still apply
README / PR / commit - concise is expected, significance padding is especially jarring
Marketing / product copy - tonal tells (boast, showcase) may be intentional but still weaken the writing
Creative fiction - many tells (tricolons, elegant variation) are legitimate devices; flag only when they read as mechanical
Wiki article - neutral voice required, promotional language is always a finding
Email - conversational is expected, formality inflation is a tell
Slides / presentation - fragments are fine, but vocabulary and tonal tells still apply
Step 3: Scan for patterns
Apply the four categories (see below). For each match, read the surrounding context - a single instance of an AI word in a 5000-word document is probably noise, but three instances in three paragraphs is a pattern.
Density heuristic (rough guide, not a hard rule):
Under 1 flagged item per 500 words - noise, usually do not flag
2-3 per 500 words - a pattern, flag the cluster as P2
4+ per 500 words - dominant voice, P1 severity, recommend structural rewrite
Short text scaling: for text under 100 words, any 2+ tells in a single paragraph is P1 severity regardless of the per-500-words threshold. A single sentence crammed with AI vocabulary is worse than a long doc with scattered instances.
Density only applies to vocabulary and syntax tells. A single travel-guide paragraph is enough to flag on its own. One fabricated citation is always P1.
Classify each finding by category, action, and severity:
Action:
Fix - clearly a tell, should change
Consider - judgment call, present it and let the user decide
Fine - matches the pattern but is justified (note why, move on)
Severity:
P1 - cluster of tells that makes the piece sound unmistakably AI-written; vague attribution passing opinion as fact; fabricated citations or broken references
P2 - vocabulary or syntax tells that dull the voice without breaking trust; formulaic structures ("Despite its X, faces challenges..."); travel-guide voice in non-travel writing
P3 - single instances of banned vocabulary; formatting nits (em-dash usage, unnecessary bold); tricolon overuse
Step 4: Report and fix
Present findings grouped by category. For each Fix-level item, show the concrete rewrite. Rewrites should be shorter or more specific - never longer.
Plan first, apply that plan only. Produce the audit report as the improvement plan before any
rewrites are merged. If the user then asks for the fixes to be applied, change only what the plan
flagged. Do not freelance edits outside the plan, do not "while we're here" rewrite adjacent
prose, and do not chain a second pass of new fixes on top of the applied ones in the same step.
This keeps the work auditable and prevents a cheap model from re-drafting the piece worse than
the original. If new findings emerge while applying, surface them as a second audit, not as
silent edits.
The Four Categories of AI Prose Slop
1. Vocabulary Tells (Noise)
Specific words that LLMs overuse far beyond their natural English frequency.
Flagged vocabulary (context-sensitive - see exceptions below):
AI word
Natural alternatives
delve
look at, examine, dig into, cover
tapestry
mix, range, variety (or just drop the metaphor)
testament
proof, evidence, example
pivotal
key, important, central (or drop if padding)
crucial
important, needed (or drop if padding)
realm
area, field, world
landscape
scene, field, mix
showcase
show, display, feature
empower
help, enable, let (or rewrite with a specific claim)
foster
build, grow, support, encourage
navigate
handle, work through, manage
nestled
set, located, built
vibrant
lively, active, busy (or drop)
underscore
show, highlight, confirm
garner
get, earn, attract
enduring
lasting, long-running
boast
have (just "has")
leverage
use
utilize
use
facilitate
help, enable
seamless
smooth (or drop)
robust
reliable, solid (or drop if padding)
commitment to
cares about, focuses on
dive deep into
look at, cover
embark on
start, begin
nuanced
subtle, careful, specific (or drop - almost always padding)
multifaceted
has many sides, covers a lot (or drop)
holistic
whole, end-to-end, full (or drop)
synergy
fit, overlap, how X and Y work together (or drop)
innovative
new, novel (or name what is new)
commence
start, begin
journey toward
work toward, move toward, aim for (or drop)
moving forward
from now on, next, going forward (or drop)
Detect:
Multiple flagged words in the same paragraph
Flagged word used metaphorically (tapestry of experiences, realm of possibility)
Flagged word in a context where a plain verb would work (showcase the features -> show the features)
Fix: Replace with the plain alternative. If the sentence gets weaker after replacement, the original was padding - cut the whole phrase.
See "What NOT to Flag" below for domain exceptions (horticulture landscape, child welfare foster, networking realm, etc.).
AI fallback character names (fiction)
Generated fiction often converges on soft, no-baggage names such as Elara, Kael, or
Voss. If a prose audit includes invented character names, read
references/fiction-name-tells.md for the fallback-name pattern, exceptions, and fix guidance.
2. Syntax Tells (Noise + Soul)
Sentence structures LLMs reach for to sound balanced or significant.
Negative parallelism
LLMs overuse not X but Y and not just X, but also Y constructions to signal balance and sophistication. In moderation this is fine English. In quantity it is a clear tell.
Detect:
Three or more not X but Y / not just X, but Y / it's not about X, it's about Y structures in a single piece
Used where a direct claim would work: this isn't just a tool, it's a platform -> this is a platform
Fix: State the positive claim directly. If the contrast matters, keep one instance and rewrite the rest.
Forced tricolons (rule of three)
X, Y, and Z lists used for rhythm rather than enumeration. LLMs default to three items even when two or four would be more accurate.
Detect:
Adjective triplets where one adjective would carry the meaning: a fast, reliable, and scalable system
Noun triplets that are really the same concept: clarity, precision, and accuracy
Three-item lists where the third item is obviously padded to hit the count
Fix: Drop the weakest item. Use two items when the point is a contrast, four or more when it is an actual list.
Copula avoidance
LLMs avoid plain is / are / has / have in favor of elaborate constructions: serves as, marks, represents, features, offers, boasts, stands as.
Detect:
serves as where is works: it serves as a backup -> it is a backup
represents used as a replacement for is: this represents a shift -> this is a shift
boasts used for has: the app boasts 50 features -> the app has 50 features
marks used to inflate: this marks the first time -> this is the first time
Fix: Use the plain copula. Elaborate verbs should carry weight - do not spend them on simple identity claims.
Adverb crutch (-ly modifiers)
LLMs reach for -ly adverbs to inflate description and dodge precise verb choice: said softly, ran quickly, smiled warmly, walked slowly, whispered quietly. Each one in isolation is acceptable English. Density is the tell. The classical fiction-editing test (Stephen King and most line editors): if dropping the adverb does not change the meaning, the verb is the problem.
Adverbs that restate the verb: whispered quietly, shouted loudly, ran quickly, mumbled under his breath
Multiple -ly adverbs in adjacent sentences (a passage sprinkled with them rather than one used for emphasis)
Stacking with hedges: gently, slightly, rather, somewhat modifying the same verb or following each other across a paragraph (cross-references "Hedging and qualifier stacking" in Tonal Tells)
Fix: Prefer a stronger verb. said softly -> whispered. ran quickly -> sprinted. smiled warmly -> beamed. looked carefully at -> studied. Delete adverbs that restate the verb outright.
Exception: Keep the adverb when it carries information the verb cannot. said reluctantly, answered honestly, arrived late, she nodded slowly (when the slowness is the point) all earn their place. The test: drop the adverb. If meaning shifts, keep it. If only rhythm shifts, the verb was weak.
Elegant variation
LLMs avoid repeating a noun within a paragraph, substituting increasingly strained synonyms. A character named Alice becomes the protagonist, the main character, the young woman, the eponymous heroine in four consecutive sentences.
Detect:
The same entity referred to by 3+ different nouns in close proximity
Strained synonyms where a pronoun or name repetition would be natural
Different technical terms for the same concept within one document
Fix: Use the name, or a pronoun. Repetition is fine. Forced variation is worse than repetition.
3. Tonal Tells (Soul)
The voice of the text gives away the author even when the words are individually defensible.
Travel-guide voice
Nestled between rolling hills, this vibrant city boasts a rich cultural heritage and a thriving arts scene. LLMs default to this register for any geographic or cultural topic.
Detect:nestled, rolling hills, vibrant, thriving, rich heritage, bustling, charming, picturesque
Fix: State facts. The city has 300,000 people, two universities, and a jazz festival in August.
Promotional tone
Our commitment to excellence ensures we foster innovation and empower our customers to succeed. LLMs reach for press-release cadence when asked to describe any organization or product.
Detect:commitment to, empower, foster, ensure, strive, dedicated to, passionate about, industry-leading, cutting-edge, next-generation
Fix: Replace with specific claims. We help X customers do Y beats We empower customers to succeed.
Vague attribution
Experts say, industry reports indicate, observers have noted, many believe. LLMs use these when they want to assert something without a source. Real writers either cite or own the claim.
Detect:
experts say / experts agree without naming experts
industry reports / studies show without a study
observers have noted / critics argue without names
Plural sources say pointing to at most one source
Fix: Cite the source. Or own the claim. Or cut it - most of the time the surrounding sentence works without the attribution.
Significance padding
This marks a pivotal moment, underscoring broader trends in the industry. LLMs inflate the weight of routine events to pad word count.
Detect:
marks a pivotal moment
underscoring broader trends
highlighting the importance of
serves as a reminder that
in an era where
in today's fast-paced world
Fix: Delete the whole sentence. If what follows does not make sense without the padding, rewrite the surrounding paragraph.
Hedging and qualifier stacking
LLMs stack hedges and qualifiers to sound cautious or balanced. Each hedge by itself is fine English; stacking them makes every claim feel tentative.
Detect:
Frequent generally, typically, often, usually, in many cases, for the most part
Weak modal stacking: may, can, might, could potentially, arguably, relatively
Two or more hedges in the same clause: can generally be considered to be relatively reliable
Hedges on claims that the author clearly knows are true: this may help with performance (when benchmarks are already in the paragraph)
Fix: Delete the hedge and state the claim. If the claim really does need a caveat, state it concretely: on Linux only, for connections over 1000 RPS - not generally speaking.
Scaffolding padding
Phrases that wrap around the actual content without adding information. LLMs lean on these to sound organized or conversational.
Detect:
it's worth noting that, it's important to note, it's worth mentioning
in this article, we'll explore / in this guide, we'll cover (meta-commentary about the piece itself)
let's dive into / let's explore / let's take a look at
here's the thing: / the fact is: / the truth is:
at the end of the day / when all is said and done
as we've seen / as mentioned earlier / as previously discussed (when the reader just read it)
Fix: Cut the wrapper and keep the content. It's worth noting that X becomes X. In this article, we'll explore Y becomes a first sentence that is about Y.
Confident filler and false emphasis
LLMs punctuate with manufactured confidence and rhetorical scaffolding that announces insight instead of delivering it.
Detect:
Emphasis crutches: Full stop., Period. (as standalone emphasis), let that sink in, make no mistake, here's why that matters
Rhetorical setups: What if..., Imagine..., Think about it:, Picture this
Faux-profundity fragment: a curt closer that asserts depth instead of earning it - <short sentence>. That's it., Simple as that., Nothing more.
Fix: Cut the wrapper; make the claim carry its own weight. Density is the tell: one earned that's it is voice, three is a tic. Overlaps significance padding (serves as a reminder that) and scaffolding padding (let's dive into); when a phrase fits more than one bucket, count it once under the densest cluster, not in every bucket it touches.
"Despite its X, faces challenges"
LLMs reach for a formula when asked to describe any organization or project: positives first, then a "however" paragraph listing challenges, often ending with a "future outlook" paragraph.
Detect: the shape of the article more than specific words. Three-paragraph structure where paragraph 1 is positive, paragraph 2 starts with Despite or However, and paragraph 3 starts with Looking ahead or The future.
Fix: Reorganize around the actual story. If there is no story, the piece probably should not exist.
4. Formatting Tells (Noise)
Layout and punctuation patterns that LLMs default to.
Detect:
Em dashes (Unicode U+2014, or the -- double-dash substitute) used as sentence breaks. LLMs overuse them to imitate journalistic cadence. Replace with single - or restructure the sentence.
Title Case in section headings (Understanding the Core Concepts vs Understanding the core concepts). AI defaults to title case even in sentence-case conventions. Match the project's style.
Excessive bold - every third noun bolded for no reason. Bold earns its use by signaling a term or path.
Bullet salad - prose turned into bullets when a paragraph would read better. Lists are for enumerations, not for every idea.
Three-bullet-happy layouts - suspicious when every list has exactly three items
Curly quotes (", ') in technical writing that should use ASCII
Emoji in professional prose where decoration is the only purpose
Decorative thematic breaks - --- before every ##. Dividers that mark a real phase change are fine; decoration is not
Markdown artifacts in rendered text - **bold** appearing as literal characters because the paste lost its format
Fix: Match the surrounding project's conventions. If there is no convention, default to plain ASCII, sentence case, minimal bold, paragraph prose.
What NOT to Flag
These look like AI tells but are not:
Direct quotations - do not edit words written by someone else, even if they contain banned vocabulary
Genre conventions - travel writing uses travel-guide voice because that is what travel writing sounds like. Marketing copy uses promotional tone. Journalism uses em-dashes. Fiction uses elegant variation and tricolons intentionally. Respect the genre.
Technical terms of art - pivotal in mechanical engineering, realm in networking or identity (Kerberos, OIDC), foster in child welfare, landscape in horticulture or graphic design, crucial experiment in philosophy of science
landscape in ML/AI contexts (optimization landscape, loss landscape, feature landscape)
robust in statistics/ML (robust estimation, robust optimization, robust regression)
Deliberate register play - satire, parody, pastiche, and stylistic experiments
Direct speech / dialog in fiction - characters can sound however they sound
Lists that are actually lists - a three-item list is only suspicious if the items are padded. An enumeration of three real things is fine
Bold where it signals a term or path - bolding a defined term on first use is standard
Em dashes in publications that require them - some style guides (Chicago, AP) allow or require em dashes. The rule applies to your project's conventions
A genuine rhetorical question or single hard fragment - one "What if X?" that the piece actually answers, or one deliberate "That's it." landing a point, is voice. Flag the pattern (stacked setups, repeated faux-profundity fragments), not the isolated use. An earned single use is not a tell, so it does not count toward the short-text density threshold or escalate to P1 on its own - it is the stacking that carries the severity.
Counter-example (prose that looks AI but is fine)
Nestled in the loss landscape near a sharp minimum, the model's robust features fail to generalize. This underscores a pivotal result from Keskar et al. (2017): flat minima tend to foster better test accuracy than sharp ones.
Looks flagged at a glance: nestled, landscape, robust, underscores, pivotal, foster. But every term is a term of art (ML optimization, statistics), underscores has a real referent, and the citation is real. Verdict: Fine. Do not flag. Domain context overrides vocabulary match.
Output Format
## Anti-AI-Prose Audit: [scope]### Findings#### [Category Name] ([count] items)**[action]** ([severity]) `path/to/file:line` - [description]
> before: [quoted text from the source]> after: [suggested rewrite]### Summary- X findings across Y files / sections
- [overall read: does the piece sound human?]
- [top-level observation: e.g., "vocabulary is mostly fine but the structure is formulaic"]
Rules for the report itself:
Omit empty categories. If there are no formatting tells, do not write an empty "Formatting Tells (0 items)" heading
Order within a category P1 > P2 > P3
Deletion fixes have no "after" - write > after: (cut) or just state the delete in the description
Apply these rules to your own audit. Run the Self-Check on the report before returning it - an audit written in AI-slop voice is not credible
Keep it concise. Show the before/after pair. Do not lecture about why AI writing is bad - the user already knows.
Worked example (anchor the format)
Input (README snippet, 48 words):
In today's fast-paced world, our platform empowers developers to seamlessly navigate the complex landscape of modern APIs. Built with a commitment to excellence, it boasts robust features and fosters innovation. Whether you're a beginner or expert, this tool serves as a pivotal resource for your journey toward better software.
Report:
## Anti-AI-Prose Audit: README snippet (48 words)
### Findings
#### Vocabulary Tells (9 items)
**Fix** (P1) line 1 - cluster of 9 flagged words in 48 words: far above 4/500 threshold
> before: empowers / seamlessly / navigate / landscape / commitment to / boasts / fosters / pivotal / journey toward
> after: (rewrite, see below)
#### Tonal Tells (2 items)
**Fix** (P1) line 1 - scaffolding padding and significance padding
> before: "In today's fast-paced world"
> after: (cut)
**Fix** (P2) line 1 - promotional tone
> before: "Built with a commitment to excellence"
> after: (cut)
### Summary
- 11 findings, one paragraph, dominant AI voice
- Rewrite: "An HTTP API client for Python. Handles auth, retries, and pagination. Works with any OpenAPI 3.x spec."
- Down from 48 words to 22, with concrete claims instead of posture
Output Contract
See references/output-contract.md for the full contract.
Skill name: ANTI-AI-PROSE
Deliverable bucket:audits
Mode: always-on. Every invocation emits the full contract - boxed inline header, body summary inline plus per-finding detail in the deliverable file, boxed conclusion, conclusion table.
Severity scale:P0 | P1 | P2 | P3 | info (see shared contract).
Related Skills
anti-slop - code quality audit. When auditing a repo, run anti-slop for code and anti-ai-prose for docs. The two are deliberately complementary.
update-docs - keeps docs accurate and trimmed after feature changes. Anti-ai-prose focuses on voice; update-docs focuses on factual drift.
prompt-generator - structures a rough draft into an LLM prompt. If the user wants to generate cleaner prose next time, this helps shape the prompt.
full-review - orchestrates code-review, anti-slop, security-audit, and update-docs. Not wired into full-review by default - invoke anti-ai-prose separately when the repo has substantial prose worth auditing.
code-review - catches logic and correctness issues. Anti-ai-prose only touches prose; code-review handles the code itself.
Rules
Read the full piece before flagging. A single delve in a 10,000-word book is not a pattern. Three in a paragraph is. Context determines severity.
Never edit quoted material. Original words from other authors stay as written.
Respect genre conventions. Travel writing, marketing, fiction, and academic prose have legitimate conventions that overlap with AI tells. Flag only when the writing is worse for the device, not because it matches a pattern.
Every rewrite must be shorter or more specific. Lateral synonym swaps are not improvements. If the rewrite is longer, the original was fine.
Plan first, apply that plan only. When applying fixes after the audit, change only what the report flagged. Do not freelance edits, do not rewrite adjacent prose, and do not chain a second pass of new fixes on top of the applied ones. New findings during application become a follow-up audit, not silent edits.
Keep the voice of the author. The goal is prose that sounds like a specific human, not a generic "good writing" rewrite. If you do not know the author's voice, leave stylistic calls alone and only flag the mechanical tells.
Do not pad the report. If there are three findings, list three. Not five. Not one inflated to three.
