# remove-ai-style

Rewrites English or Chinese prose to drop formulaic phrasing, stray dashes and exclamation marks. Useful before you publish an article or a doc.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4200 installs
- Author: zc277584121
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zc277584121/marketing-skills/tree/HEAD/skills/remove-ai-style/SKILL.md
- Updated: 2026-08-28
- HTML: https://affpapa.org/en/nevibecode/skills/remove-ai-style

## What it does

The skill runs a two-layer pass. A deterministic Markdown analyzer goes first and flags repeatable signals: word choice, punctuation, structure, leftover assistant phrasing. Then the agent reads the whole piece and fixes what no rule list can catch — symmetrical argument, paragraphs that repeat the same move in fresh words, empty evaluative adjectives, sentences that explain the point to the reader.

Three rule families are hard constraints on editable prose. Every exclamation mark goes. So do em dashes, en dashes and double hyphens standing in for a dash, along with formulaic binary contrasts such as “not just X but Y”. After the rewrite, rerunning the analyzer with `--fail-on-hard-constraints` should report zero for those counters. Code, URLs, Markdown targets and quoted source that must stay verbatim are the exception.

You need `python3` and a path to the article, or the text piped through stdin. The analyzer lives at `scripts/analyze_ai_style.py` inside the skill folder, and swapping it for hand-rolled `grep` lines defeats the purpose — detection logic sits in that script. Before editing, the skill records what has to survive: YAML frontmatter, fenced code, tables, images and links, HTML comments, full `VISUAL_TODO` blocks. Numbers, facts, URLs and citation targets stay as they are, even when a smoother sentence is tempting.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill remove-ai-style -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/remove-ai-style/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/remove-ai-style/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill remove-ai-style -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/remove-ai-style/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill remove-ai-style -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/remove-ai-style/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install zc277584121/marketing-skills remove-ai-style
```

2. **Manually: put the files in place**
- File: `.github/skills/remove-ai-style/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill remove-ai-style -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/zc277584121/marketing-skills --path skills/remove-ai-style
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/remove-ai-style/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill remove-ai-style -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/zc277584121/marketing-skills/tree/HEAD/skills/remove-ai-style/SKILL.md

## When to use it
- clear exclamation marks and dashes before publishing
- turn formulaic binary contrasts into direct claims
- spot repeated paragraph logic hiding behind new vocabulary
- cut empty evaluative adjectives and decorative transitions
- check a generated article for assistant-style residue

## Example prompts
- Run the analyzer on `article.md` and show me the JSON report
- Rewrite the flagged spots in `draft.md`, keep the facts and structure
- Rescan with `--fail-on-hard-constraints` and list what is left

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [domain-modeling](https://affpapa.org/en/nevibecode/skills/domain-modeling.md) — skill · 876391 installs

From the same set: [zc277584121/marketing-skills](https://affpapa.org/en/nevibecode/by/zc277584121/marketing-skills.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md