Skip to content
appsgit

Clarity

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.

github.com/addyosmani/clarity (opens in a new tab)

Data as of from the GitHub API and skills.sh; description from the skill's SKILL.md. Report an error

View on GitHub (opens in a new tab)View on skills.sh (opens in a new tab)

Add this skill

Claude

Claude Code loads skills from ~/.claude/skills/ (all projects) or .claude/skills/ (one project):

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 clarity folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

ChatGPT / Codex

Codex reads skills from .agents/skills/ in a repo or ~/.agents/skills/ for every project:

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

Standalone skills also load in the ChatGPT desktop app.

Cursor

Cursor loads skills from .cursor/skills/ (or ~/.cursor/skills/) and also reads .claude/skills/:

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

Source (checked Oct 7, 2026): code.claude.com/docs/en/skills (opens in a new tab), support.claude.com/en/articles/12512180-using-skills-in-claude (opens in a new tab), learn.chatgpt.com/docs/build-skills (opens in a new tab), cursor.com/docs/context/skills (opens in a new tab)

What this skill does

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.

When it triggers

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

Similar skills

More docs & writing skills

All Docs & writing

FAQ

Clarity FAQ

Still curious? Email info@appsgit.com.

How do I install the Clarity skill?

Copy the clarity folder (the one containing SKILL.md) into ~/.claude/skills/ for Claude Code, .agents/skills/ for Codex or .cursor/skills/ for Cursor. The agent picks it up automatically when a task matches its description.

Is the Clarity skill free?

Yes. The repository is open source under the MIT license.

Is Clarity maintained?

The repository's most recent commit was on Sep 5, 2026. Its latest release is v0.2.1. appsgit only lists skills from repositories with a commit in the last six months.