ai-writing-detox

$npx mdskill add jamditis/claude-skills-journalism/ai-writing-detox

Remove AI writing patterns to restore reader trust and credibility.

  • Eliminates noticeable AI patterns that undermine content credibility.
  • Relies on a curated list of banned words and phrases.
  • Scans text for banned words and suggests replacements or deletions.
  • Outputs cleaned text with human-sounding alternatives applied.

SKILL.md

.github/skills/ai-writing-detoxView on GitHub ↗
---
name: ai-writing-detox
description: Eliminate AI-generated writing patterns that erode reader trust. Activate when writing articles, documentation, press releases, or any content where AI patterns would undermine credibility. For journalists using AI assistance who need human-sounding output.
---

# AI writing detox

Good writing is invisible. If readers notice the writing style, it's distracting from the content. AI patterns are noticeable—they break trust.

## When to use

- Writing or editing any journalism content
- Creating press releases or media advisories
- Drafting documentation or reports
- Writing social media posts
- Reviewing any AI-assisted text before publication

## Banned words (delete or replace)

| Word | Why it's bad | Alternative |
|------|--------------|-------------|
| delve | AI signature word | explore, examine, look at |
| realm | Pretentious | area, field |
| tapestry | Purple prose | (delete entirely) |
| landscape | Corporate speak | situation, environment |
| leverage | Jargon | use |
| utilize | Jargon | use |
| robust | Meaningless | strong, reliable |
| seamless | Almost always false | smooth, easy |
| comprehensive | Rarely necessary | full, complete |
| cutting-edge | Cliché | modern, new |
| holistic | Corporate | complete, full |
| synergy | Corporate | (delete, rewrite) |
| paradigm | Overused | model, approach |
| empower | Vague | (be specific about what capability) |
| innovative | Empty praise | (describe what's new) |
| transformative | Hyperbolic | changed, improved |
| sophisticated | Vague filler | advanced, or describe what's complex |
| leveraging | Corporate jargon | using |
| ecosystem | Overused metaphor | system, environment |
| rich | (as modifier) | (delete or be specific) |
| over (for quantity) | AP rule | more than |

## Banned phrases

### Throat-clearing (delete entirely)

- "It's important to note that..."
- "In today's [X] landscape..."
- "Let's dive/delve into..."
- "Without further ado..."
- "In this article, we will..."
- "It's worth mentioning that..."
- "It goes without saying..."
- "As we all know..."

### Empty hedges

- "To be fair..." / "To be honest..."
- "At the end of the day..."
- "When it comes to..."
- "In terms of..."
- "With respect to..."

### AI enthusiasm

- "This is a game-changer"
- "...and that's a good thing!"
- "Here's the thing:"
- "...and that's okay!"
- "...and I'm here for it"

### Corporate buzzwords

- "Moving forward..."
- "Going forward..."
- "At this point in time..."
- "Due to the fact that..."
- "In order to..."

## Banned structures

### Don't start sentences with:

- "So," or "Well,"
- "Now," (when not about time)
- "Look," or "Listen,"
- "Basically," or "Essentially,"

### Don't end sentences with:

- "...right?"
- "...you know?"
- "...if you will"

## The substitution table

| If you wrote | Write instead |
|--------------|---------------|
| utilize | use |
| facilitate | help |
| implement | build, add, create |
| leverage | use |
| functionality | feature |
| methodology | method |
| in order to | to |
| due to the fact that | because |
| at this point in time | now |
| a large number of | many |
| in the event that | if |
| prior to | before |
| subsequent to | after |
| in close proximity to | near |
| has the ability to | can |

## Case sensitivity

**Always use sentence case for headings, not title case.**

| Wrong | Right |
|-------|-------|
| Getting Started With Your Project | Getting started with your project |
| How To Use The Tool | How to use the tool |
| Best Practices For Journalism | Best practices for journalism |

## Journalism-specific patterns to avoid

### "Not just X—it's Y" pattern

**Avoid:** "This isn't just a news story—it's a wake-up call"
**Avoid:** "This wasn't just a press conference—it was a turning point"

**Do instead:** State the thing directly without dramatic framing

### "Fundamentally transforms" pattern

**Avoid:** "This fundamentally transforms how newsrooms operate"
**Avoid:** "This represents a fundamental shift in journalism"

**Do instead:** Describe the actual change without hyperbole

### Inflated claims in reporting

**Avoid:** "A bombshell revelation"
**Avoid:** "A major milestone"
**Avoid:** "A groundbreaking investigation"

**Do instead:** Let the facts speak. Readers judge significance.

### Empty transitions

**Avoid:** "With that in mind..."
**Avoid:** "Building on this foundation..."
**Avoid:** "Taking this a step further..."

**Do instead:** Just make the next point

### "It's not about X, it's about Y" pattern

**Avoid:** "It's not about the technology, it's about the people"
**Avoid:** "This isn't about clicks. It's about trust."

**Do instead:** State the actual point without rhetorical setup. The X-not-Y construction is the dominant 2025-2026 ChatGPT/Claude rhetorical signature.

### Em-dash overuse between independent clauses

**Avoid:** "The vote was close — only three council members opposed it — but the measure passed."
**Avoid:** "Reporters arrived early — the press conference was already underway."

**Do instead:** Use commas, periods, or semicolons. Em-dashes are fine in moderation; reflexive use across every paragraph is a tell.

### "The reality is..." / "The truth is..." openers

**Avoid:** "The reality is, most newsrooms can't afford this."
**Avoid:** "The truth is, readers don't trust anonymous sources."

**Do instead:** Just state the claim. The opener adds words and signals AI-generated framing.

### Tricolon abuse (reflexive three-item lists)

**Avoid:** "Clear, concise, and compelling reporting."
**Avoid:** "Trust is built through accuracy, transparency, and consistency."

**Do instead:** Use one or two specific points. Three-item parallel lists are an AI rhythm pattern that reads as filler when used reflexively.

## Before and after examples

### Example 1: General prose

**AI slop:**
> In today's rapidly evolving media landscape, it's crucial to understand the multifaceted nature of AI tools. Let's delve into how these robust solutions can help journalists leverage cutting-edge technology.

**Human writing:**
> AI tools do three things well: drafting, research, and analysis. Here's when to use each.

### Example 2: News lede

**AI slop:**
> The city council meeting was a comprehensive and transformative discussion that fundamentally addressed key issues affecting residents in a meaningful way.

**Human writing:**
> The city council voted 5-2 Tuesday to raise property taxes by 3 percent.

### Example 3: Feature intro

**AI slop:**
> In the rich tapestry of American journalism, few stories are as compelling as the one about to unfold. This isn't just a profile—it's a journey into the heart of what makes local news truly matter.

**Human writing:**
> Maria Rodriguez has published a newspaper for 47 years. She's never missed an issue.

### Example 4: Analysis piece

**AI slop:**
> Moving forward, stakeholders must leverage innovative approaches to navigate the challenging landscape of digital transformation in the journalism ecosystem.

**Human writing:**
> Local papers that want to survive need to find digital revenue. Most haven't.

## The verbal tic test

Read your text aloud. Does it sound like:
- A TED talk introduction? **Rewrite.**
- A LinkedIn post? **Rewrite.**
- A press release? **Rewrite.**
- Corporate communications? **Rewrite.**
- How you'd explain it to a colleague? **Keep it.**

## Quick self-check before publishing

Search your text for:
1. "delve" → delete or replace
2. "landscape" → delete or replace
3. "crucial" → is it actually crucial?
4. "robust" → what does this mean here?
5. "leverage" → just say "use"
6. "comprehensive" → is this word doing any work?
7. Starting "So," → delete

Found any? Your writing needs another pass.

## Red flags in technical/analysis writing

1. **Lists of near-synonyms**: "comprehensive, sophisticated, and robust" (pick one or none)
2. **Excessive hedging**: "may potentially be able to possibly..."
3. **Noun stacking**: "production-ready deployment system infrastructure"
4. **Passive voice hiding agency**: "It was determined that..." (by whom?)
5. **Circular definitions**: "The system enables users to use the functionality"

## The ultimate test

Before accepting any AI-assisted text, ask:

1. Can I delete this word/phrase without losing meaning? → Delete it
2. Is this the simplest way to say this? → Simplify
3. Would I say this out loud to a colleague? → If not, rewrite
4. Does this add information or just sound impressive? → If the latter, cut it

If readers think "AI wrote this," you've already lost their trust.

---

*Good writing is invisible. If readers notice the writing, it's getting in the way of the content.*

*See also: hooks/ai-slop-detector.md for the automated companion to this skill.*

More from jamditis/claude-skills-journalism

SkillDescription
academic-writingAcademic writing, research methodology, and scholarly communication workflows. Use when writing papers, literature reviews, grant proposals, conducting research, managing citations, preparing for peer review, choosing OA routes under Plan S / 2026 OSTP Nelson Memo, posting preprints, working with persistent identifiers (ORCID, DOI, ROR), assigning CRediT contributor roles, preregistering analyses on OSF / AsPredicted, or disclosing LLM use to journals and funders. Essential for researchers, graduate students, and academics across disciplines.
accessibility-complianceWeb accessibility patterns for news sites, journalism tools, and academic platforms. Use when building accessible interfaces, auditing existing sites for WCAG compliance, writing alt text for news images, creating accessible data visualizations, or ensuring content reaches all readers including those using assistive technologies. Essential for newsroom developers and anyone publishing web content.
api-hardeningAPI security hardening patterns. Use when implementing rate limiting, input validation, CORS configuration, API key management, request throttling, or protecting endpoints from abuse. Covers defense-in-depth strategies for REST APIs with practical implementations for Express, FastAPI, and serverless, oriented around the OWASP API Security Top 10:2023.
claude-md-updater>-
content-accessLegal methods for accessing paywalled and geo-blocked content. Use when researching behind paywalls, accessing academic papers, bypassing geographic restrictions, or finding open access alternatives. Covers Unpaywall, library databases, VPNs, and ethical access strategies for journalists and researchers.
crisis-communicationsCrisis communication and rapid response workflows for journalists and communications professionals. Use when covering breaking news events, managing organizational communications during crises, coordinating rapid fact-checking efforts, or developing crisis response plans. Essential for newsrooms, PR teams, and anyone who needs to communicate accurately under time pressure.
data-journalismData journalism workflows for analysis, visualization, and storytelling. Use when analyzing datasets, creating charts and maps, cleaning messy data, calculating statistics or building data-driven stories. Essential for reporters, newsrooms and researchers working with quantitative information.
digital-archiveDigital archiving workflows with AI enrichment, entity extraction, and knowledge graph construction. Use when building content archives, implementing AI-powered categorization, extracting entities and relationships, or integrating multiple data sources. Covers patterns from the Jay Rosen Digital Archive project.
document-designThis skill should be used when the user asks to "create a proposal", "design a report", "make a one-pager", "build a PDF", "create a newsletter", "design slides", "make event materials", "design a flyer", or needs help with print-ready HTML documents. Provides brand configuration, CSS patterns for print layout, and document design best practices.
editorial-workflowManage editorial workflows for newsrooms and publications. Use when tracking story assignments, managing deadlines, coordinating editorial calendars, or establishing handoff protocols between reporters and editors. Includes templates for assignment tracking, editorial calendars, and workflow documentation.