
ai-writing-detox
Eliminates AI-generated writing patterns that erode reader trust. Use when writing or editing articles, docs, or press releases.
- Installs
- 318
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/jamditis/claude-skills-journalism --skill ai-writing-detox- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads ai-writing-detox automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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:
- "delve" → delete or replace
- "landscape" → delete or replace
- "crucial" → is it actually crucial?
- "robust" → what does this mean here?
- "leverage" → just say "use"
- "comprehensive" → is this word doing any work?
- Starting "So," → delete
Found any? Your writing needs another pass.
Red flags in technical/analysis writing
- Lists of near-synonyms: "comprehensive, sophisticated, and robust" (pick one or none)
- Excessive hedging: "may potentially be able to possibly..."
- Noun stacking: "production-ready deployment system infrastructure"
- Passive voice hiding agency: "It was determined that..." (by whom?)
- Circular definitions: "The system enables users to use the functionality"
The ultimate test
Before accepting any AI-assisted text, ask:
- Can I delete this word/phrase without losing meaning? → Delete it
- Is this the simplest way to say this? → Simplify
- Would I say this out loud to a colleague? → If not, rewrite
- 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.
Reference files
Read Simplified technical English for newsroom and technical prose when clarity, controlled terms, or procedural register matters.
Read Slop-era principles when polished output may hide weak intent, evidence, or review.
FAQ
What does the ai-writing-detox skill do?
Eliminates AI-generated writing patterns that erode reader trust. Use when writing or editing articles, docs, or press releases.
How do I install ai-writing-detox?
Run npx skills add https://github.com/jamditis/claude-skills-journalism --skill ai-writing-detox in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ai-writing-detox/ (personal) or .claude/skills/ai-writing-detox/ (project).
Which AI agents can use ai-writing-detox?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is ai-writing-detox safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains ai-writing-detox?
It is published by jamditis in jamditis/claude-skills-journalism. It has 318 recorded installs.
More from jamditis/claude-skills-journalism
web-scraping
jamditis/claude-skills-journalism
Authorized web scraping with fallback cascades and access-failure handling. Use for social media, yt-dlp, CAPTCHA or 403 blocks.
academic-writing
jamditis/claude-skills-journalism
Scholarly writing and research compliance. Use for CRediT, preregistration, Plan S, Nelson Memo, preprints, ORCID, LLM disclosure.
page-monitoring
jamditis/claude-skills-journalism
Web page change detection, availability tracking, and RSS feed generation. Use to monitor changes, downtime, or make a feed.
fact-check-workflow
jamditis/claude-skills-journalism
Structured fact-checking workflow. Use when verifying claims for publication, rating claims, or setting pre-publication checks.
pdf-design
jamditis/claude-skills-journalism
Designs PDF reports and proposals from HTML with previews and branding. Use to create, export, or securely upload a PDF.
source-verification
jamditis/claude-skills-journalism
Verify sources, claims, images, video, documents, interviews, and synthetic media with SIFT and a durable evidence trail. Use before relying on uncertain material.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.