# Clarity (agent skill)

> Clarity is an agent skill (a SKILL.md file) from addyosmani/clarity. Draft, rewrite, or review reader-facing prose so it is specific, useful, and recognizably the author's without inventing facts or performing humanness. It works with Claude Code and Codex and has 315 GitHub stars.

Draft, rewrite, or review reader-facing prose so it is specific, useful, and recognizably the author's without inventing facts or performing humanness. Use for essays, articles, newsletters, documentation, talks, launch copy, and other important prose that feels generic, hollow, or AI-shaped. Supports co-write, rewrite, review, and lint modes. Good prose gives a particular reader something worth carrying away.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/addyosmani/clarity |
| Skill path | SKILL.md |
| Skill name | clarity |
| GitHub stars | 315 |
| Installs on skills.sh | 4 |
| License | MIT |
| Skills in repo | 1 |
| Plugin marketplace | no |
| Official | no |
| Works with | Claude Code, Codex |
| Category | Docs & writing |
| Last commit | Sep 5, 2026 |

## When it triggers

- Use for essays, articles, newsletters, documentation, talks, launch copy, and other important prose that feels generic, hollow, or AI-shaped.

## Add this skill

### Claude Code

```sh
git clone --depth 1 https://github.com/addyosmani/clarity.git
cp -r clarity ~/.claude/skills/clarity   # personal, or .claude/skills in a project
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
git clone --depth 1 https://github.com/addyosmani/clarity.git
cp -r clarity .agents/skills/clarity   # repo; ~/.agents/skills for all projects
```

### Cursor

```sh
git clone --depth 1 https://github.com/addyosmani/clarity.git
cp -r clarity .cursor/skills/clarity   # project; ~/.cursor/skills for all projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

skills.sh listing: https://www.skills.sh/addyosmani/clarity/clarity

---

Canonical page: https://appsgit.com/skills/addyosmani-clarity
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.