←Leaderboard/Writing/clarity
Last commit on September 5, 2026·Created on August 20, 2026

addyosmani/clarity

“Draft and revise clear, specific prose.”
Combined rank
#657
across all skills
In Writing
#25
category rank
Stars
346
+4.2% in last 7d
Forks
32
0.0% in last 7d
Watchers
4
+33.3% in last 7d
Traction scoreGitHub stars can be faked, so popularity alone can be misleading. Traction Score looks for broader signs of recent attention, adoption, and active maintenance.
TL;DR

Clarity helps technical writers and authors draft, rewrite, or review long-form prose such as documentation, newsletters, and essays. It focuses on removing generic or hollow phrasing to ensure the writing remains recognizably the author's own.

The skill provides structured modes for co-writing, rewriting, reviewing, and linting to ensure that launch copy and articles are precise without inventing facts.

WHO IT'S FOR
Technical writers
reviewing reader-facing documentation for clarity
Content creators
drafting newsletters and long-form articles
Marketing and communications professionals
refining launch copy and promotional emails
Public speakers
editing scripts for talks and speeches
Repository contents

1 skill file

Compatible AgentsThe repository documents support for these agents. The skills may also work with other agents that can load SKILL.md files, but they may need some setup or small changes.

Use this skill

Follow the documented setup, then try a first task.

Install with NPM

Installs: Clarity Agent Skill from the addyosmani/clarity repository

  1. Run this terminal command to install the Clarity skill:

    npx skills add addyosmani/clarity
SKILL.md ↗ · Checked Nov 5, 2026README.md ↗ · Checked Nov 5, 2026

Give it something to do.

Suggested first task

Review a draft without changing it

Uses clarity

  • Replace draft.md with the path to the existing prose draft you want reviewed.
Use clarity in review mode to critique draft.md. Leave the file unchanged.
SKILL.md ↗ · Checked Nov 5, 2026README.md ↗ · Checked Nov 5, 2026