skills/ai-writing-detox/SKILL.md
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. Essential for journalists using AI assistance who need human-sounding output.
npx skillsauth add ValorInvestigator/claude-plugin-toolkit ai-writing-detoxInstall 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.
Good writing is invisible. If readers notice the writing style, it's distracting from the content. AI patterns are noticeable—they break trust.
| 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 | | rich | (as modifier) | (delete or be specific) |
| 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 |
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 |
❌ "This isn't just a news story—it's a wake-up call" ❌ "This wasn't just a press conference—it was a turning point"
✅ State the thing directly without dramatic framing
❌ "This fundamentally transforms how newsrooms operate" ❌ "This represents a fundamental shift in journalism"
✅ Describe the actual change without hyperbole
❌ "A bombshell revelation" ❌ "A major milestone" ❌ "A groundbreaking investigation"
✅ Let the facts speak. Readers judge significance.
❌ "With that in mind..." ❌ "Building on this foundation..." ❌ "Taking this a step further..."
✅ Just make the next point
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.
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.
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.
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.
Read your text aloud. Does it sound like:
Search your text for:
Found any? Your writing needs another pass.
Before accepting any AI-assisted text, ask:
Remember: 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.
development
# Write Article -- Investigative Series in Levi Bakke's Voice You are ghostwriting publishable investigative journalism in Levi's voice. He is a participant-investigator -- IN the story, not observing from outside. ## BEFORE WRITING Read the style guide: [references/style-guide.md](references/style-guide.md) Read the gold standard: `C:\Users\Big Levi\Desktop\DHS Stories\the Canary FINAL.txt` ## THE WRITING PROCESS 1. **Gather** -- Read relevant timeline docs, investigation files, databases
development
Dual-engine web search using BOTH Firecrawl AND Brave Search simultaneously. ALWAYS trigger this skill when Levi uses any of these phrases or close variations: - "search the web" / "search the internet" / "search online" - "www" (used as a verb or shorthand, e.g. "www this", "look it up on the www") - "internet" (as in "check the internet", "find on the internet", "look this up on the internet") - "go online", "look this up online", "check online" - "search for X" when context implies web search (not local files or database) - "find X online", "look up X", "research X on the web" This is Levi's preferred web research protocol. Both engines run together -- Brave for fast broad coverage, Firecrawl for deep scraping. Never use just one without the other when this skill triggers.
development
Web scraping with anti-bot bypass, content extraction, undocumented APIs and poison pill detection. Use when extracting content from websites, handling paywalls, implementing scraping cascades or processing social media. Covers requests, trafilatura, Playwright with stealth mode, yt-dlp and instaloader patterns.
development
# Text to Voice -- Convert Articles to Audio Convert written articles to spoken audio (.mp3) using Google Cloud TTS with Chirp 3: HD Algieba voice. ## VOICE PROFILE - **Voice:** `en-US-Chirp3-HD-Algieba` (male, Chirp 3: HD) - **Speaking Rate:** `1.0` | **Volume Gain:** `0.0` dB - **Audio Encoding:** MP3, 44100 Hz, 192k bitrate (final stitch) - **API Version:** `texttospeech_v1beta1` (Chirp 3 HD requires v1beta1) - **Google Cloud Project:** `valorinvestigates` ## THE TWO-STEP PROCESS 1. **Rew