# clear-writing

The clear-writing Claude Code skill clarifies prose during drafting, editing, rewriting, and review. It targets sentences that feel dense, vague, or awkward.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 67 repo stars
- Author: wanderingspirit03
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/wanderingspirit03/clear-writing-skill/tree/HEAD/SKILL.md
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/clear-writing

## What it does

The skill revises sentences so their main actor and action are easier to spot. It brings key actions into verbs, keeps subjects close to verbs, and arranges information to connect with what came before. The writer’s meaning, qualifications, and emphasis stay intact.

It reads the passage first, tracks the ideas and relationships that must remain, then checks the revision against the original. During reviews, it separates necessary fixes from optional changes. The skill handles sentence-level clarity; it does not override subject-matter, legal, academic, or house-style requirements. A reference file, `references/sentence-clarity.md`, covers difficult cases.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install wanderingspirit03/clear-writing-skill clear-writing
```

2. **Manually: put the files in place**
- File: `.github/skills/clear-writing/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/wanderingspirit03/clear-writing-skill
```

### Windsurf (Devin Desktop)

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

### 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/wanderingspirit03/clear-writing-skill/tree/HEAD/SKILL.md

## When to use it
- clarify overloaded sentences
- replace buried actions with specific verbs
- retain qualifications while rewriting prose
- offer a concrete revision for an unclear passage

## Example prompts
- Edit this paragraph for clarity while preserving the writer’s meaning and uncertainty.
- Rewrite this passage so each action has a clear actor.
- Review this sentence and suggest a clearer order for its ideas.

## Similar
- [better-writing](https://affpapa.org/en/nevibecode/skills/forjd-better-writing.md) — skill · 624 installs
- [prose-crafting](https://affpapa.org/en/nevibecode/skills/prose-crafting.md) — skill · 2500 installs
- [sepia](https://affpapa.org/en/nevibecode/skills/sepia.md) — skill · 1800 installs
- [clarity](https://affpapa.org/en/nevibecode/skills/clarity.md) — skill · 1800 installs
- [dedash](https://affpapa.org/en/nevibecode/skills/dedash.md) — skill · 1700 installs
- [prose-style](https://affpapa.org/en/nevibecode/skills/jwynia-prose-style.md) — skill · 576 installs

---
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
