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 alenazaharovaux/share 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) |
The most recognizable AI writing pattern is choppy dramatic fragments — short sentence followed by a contradicting fragment, used for rhetorical punch. Humans don't write this way. It reads as artificial and manipulative.
❌ "Police estimated fifty victims. The court proved two. Not a series." ❌ "He was arrested. Tried. Convicted. Not as a serial killer." ❌ "Cases exist. Data exists. A system does not."
✅ Weave the contrast into a flowing sentence: "Police estimated fifty victims, but the court proved only two." "He was arrested, tried, and convicted — though not as a serial killer, because the category didn't exist."
❌ "She sold poison for decades. To women who wanted their husbands dead." ❌ "Two investigations. Same region. Neither knew about the other."
✅ Complete the sentence: "She sold poison for decades to women who wanted to be rid of their husbands." "Two investigations ran in parallel in the same region, and neither knew about the other."
❌ "No definition. No unit. No database. No research program."
✅ Use a proper sentence with a list: "There was no definition, no specialized unit, no database, and no research program."
This pattern is the #1 tell that text was AI-generated. Readers recognize it instantly — even if they can't name it. It feels like a screenplay, not journalism. Real journalists write flowing sentences with natural rhythm variation. Short sentences are fine — but fragments used for dramatic effect are not.
| 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
Full product-market fit cycle for one product — from initial hypothesis to post-launch metrics. 10 stages: setup → hypothesis (7 dimensions) → market research → risk synthesis → DVF validation → interview prep → field → interview synthesis → MVP → metrics (Sean Ellis + retention + Levels of PMF) → iterate. Resumes between sessions based on the project folder state. Bilingual (English + Russian) — picks the language during first-run setup. TRIGGER on ANY: - "do PMF for [product]" / "I need product market fit for X" / "PMF [name]" - "start PMF cycle" / "I want to go through PMF" / "help me validate [idea]" - "continue PMF" / "continue PMF [name]" - "check PMF" / "what stage is my PMF at" / "show my PMF projects" - "is my product ready to launch" - "сделай PMF для [продукта]" / "нужен product market fit для X" / "PMF [имя]" - "запусти PMF цикл" / "хочу пройти PMF" / "помоги валидировать [идею]" - "продолжаем PMF" / "продолжай PMF [имя]" - "проверь PMF" / "на каком этапе у меня PMF" / "покажи мои PMF проекты" - "готов ли мой продукт к запуску" - User mentions a product and wants to validate it systematically
testing
Use when choosing a narrative strategy before writing any text — articles, pitches, essays, reports, personal posts. Also use mid-writing to check tone, get next-block guidance, or shift narrative. Triggers: «writing guru», «подбери нарратив», «какой нарратив выбрать», «нарративная стратегия», «narrative strategy», «guru, проверь фрагмент», «guru, что дальше», «guru, хочу сменить тональность».
development
Generate self-contained HTML pages that visually explain systems, data stories, investigations, editorial workflows, and code changes. Use when the user asks for diagrams, architecture views, visual diffs, data tables, timelines, source maps, or any structured visualization that would be painful to read as terminal output. Also activates for tables with 4+ rows or 3+ columns. Adapted from nicobailon/visual-explainer with journalism, newsroom, and academic design sensibilities.
development
Run a full UX audit on any website: Nielsen heuristics, conversion, content, technical quality, information architecture. Produces a prioritized report with evidence-based findings and actionable recommendations. Use when asked to review a site, check a landing page, find UX problems, evaluate usability, assess conversion, or anything like "what's wrong with this site", "review the website", "audit UX", "check the forms", "why isn't the site converting".