Overview
avoid-ai-writing is an open-source docs skill for Claude Code and compatible agents, published by wshobson. Its author describes it as: “Audit and rewrite prose so it stops reading as machine-generated. Use this skill when asked to remove AI-isms, clean up AI writing, edit a draft for AI tells, audit a README, changelog, release note, PR description, o…”. The project has 39k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add wshobson/agents`.
What avoid-ai-writing does
Find the patterns that make text read as machine-generated, then fix them without sanding off the author's voice.
Best for
What’s inside
The SKILL.md for avoid-ai-writing is organised into these sections:
- What a flag proves
- Modes
- The pass
- Rewriting without installing a new accent
- Escape hatch
- Output
Installation
Add avoid-ai-writing to your agent with:
/plugin marketplace add wshobson/agentsReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
- Codex — declared in the repository topics
- Cursor — declared in the repository topics
- OpenCode — declared in the repository topics
- GitHub Copilot — declared in the repository topics
- Antigravity — declared in the repository topics
License
avoid-ai-writing is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in wshobson/agents, an established project with 39,066 GitHub stars
- Works with Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, Antigravity
- Actively maintained — repository updated in the last 90 days
Author
Topics
Frequently asked questions
- What does avoid-ai-writing do?
- Audit and rewrite prose so it stops reading as machine-generated. Use this skill when asked to remove AI-isms, clean up AI writing, edit a draft for AI tells, audit a README, changelog, release note, PR description, or blog post for machine-sounding prose, or make text sound less like AI. Supports a detect-only mode, a rewrite mode, and an edit-in-place mode, with optional voice and context profiles.
- How do I install avoid-ai-writing?
- Run /plugin marketplace add wshobson/agents in your agent, then reload your skills. Review the source at https://github.com/wshobson/agents before installing.
- Is avoid-ai-writing free to use?
- Yes. avoid-ai-writing is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.
- Which agents does avoid-ai-writing work with?
- avoid-ai-writing lists Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Antigravity — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does avoid-ai-writing come from?
- avoid-ai-writing ships inside wshobson/agents, a repository that contains 54 catalogued skills in total. The repository's 39,066 GitHub stars apply to that whole collection, not to this skill on its own.
