Clarity — скилл
Скилл Эдди Османи для ясного письма: интервью и черновик из ваших слов, правка готового текста, разбор без изменения файла
- 281 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Скилл читает файлы черновиков, которые вы указали, и в режиме `rewrite` правит их, режимы `review` и `lint` файл не меняют
- Скрипты `strip_markdown.py` и `prose_stats.py` запускаются у вас локально и только печатают диагностику
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/clarityОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл читает файлы черновиков, которые вы указали, и в режиме `rewrite` правит их, режимы `review` и `lint` файл не меняют
- Скрипты `strip_markdown.py` и `prose_stats.py` запускаются у вас локально и только печатают диагностику
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Clarity — скилл Эдди Османи для агентов, который применяет правила ясного письма, когда вы пишете, правите или проверяете прозу. Режим выбирают первым словом после `/clarity`. `interview` ведет интервью по теме и пишет текст из ваших примеров и формулировок, `rewrite` правит готовый черновик, `review` дает разбор и не трогает файл, `lint` и `stats` запускают диагностику без правки текста. Без слова режима скилл определяет задачу по запросу. Перед правкой стиля скилл задает вопросы по существу: для кого текст, что читатель уже знает и что должен унести. Он не выдумывает факты, цифры, цитаты и личный опыт, оставляет атрибуцию на месте и не обещает результат детектора ИИ. Под режим подгружается свой справочник: `interview.md`, `edit.md`, `review.md`, для эссе и статей добавляется `longform.md`, для документации, писем и интерфейсных текстов `medium.md`. Скрипты `strip_markdown.py` и `prose_stats.py` на Python показывают, где в тексте привычные приметы, но общий балл не выводят.
Для кого. Для авторов блогов, рассылок, документации и докладов, которые пишут с агентом и хотят сохранить свой голос и факты.
Подходит, если
- Есть черновик эссе или статьи, который звучит гладко и пусто: скилл вычистит общие слова, не придумывая деталей
- Хочется написать текст с нуля, но материала мало: режим интервью вытащит ваши примеры и позицию вопросами
- Нужен разбор черновика с оценкой, который не меняет файл: режим `review`
- Надо проверить рассылку, запуск продукта или документацию на приметы машинного текста
- Хочется увидеть статистику по тексту: длину предложений и повторы через `prose_stats.py`
Не подходит, если
- Нужно пройти детектор ИИ: скилл не оптимизирует под детекторы и не обещает их результат
- Нужно вставить в текст примеры и истории, которых нет в вашем материале: скилл ничего не сочиняет
- Нужен перевод или проверка орфографии: режимы скилла посвящены структуре, смыслу и стилю прозы
- Нужны правила для текста на русском: справочники и образцы написаны на английском
Пример запроса к агенту
/clarity review draft.md: разбери черновик статьи про наши инцидент-ревью и скажи, где он не говорит ничего конкретного, файл не меняйОграничения
Справочники, образцы и примеры в репозитории написаны на английском, проверку на русских текстах автор не описывает. Скрипты линтера требуют Python 3. Скилл не гарантирует результат детектора ИИ и не доказывает авторство, об этом автор говорит прямо. Результаты оценок в папке `evals` автор обещает публиковать вместе с версиями моделей, а победу в сравнении репозиторий не заявляет.
В браузерной версии на clarity.addy.ie черновик не загружается на сервер.
Как отключить. Удалите папку `clarity` из каталога скиллов проекта или из `~/.claude/skills/`. Если копировали обертки, удалите `clarity-interview.md`, `clarity-rewrite.md` и `clarity-review.md` из `~/.claude/commands/`.
Частые вопросы
Как поставить Clarity в Claude Code?
Выполните `npx skills add addyosmani/clarity` или `pnpm dlx skills add addyosmani/clarity`. После этого команда `/clarity` принимает режим первым словом: `rewrite draft.md`, `review draft.md` или `interview <тема>`. Отдельные команды `/clarity-interview`, `/clarity-rewrite` и `/clarity-review` появятся после копирования файлов из `commands/` в `~/.claude/commands/`.
Чем режим интервью отличается от обычной просьбы написать текст?
Скилл сначала спрашивает у вас примеры, формулировки, сомнения и позицию, а потом собирает черновик из сказанного. Так в тексте остаются вещи, которые модель сама не придумает. В папке `samples/` лежит стенограмма интервью рядом с готовым текстом, поэтому происхождение можно проверить.
Обманывает ли Clarity детекторы ИИ?
Нет. Скилл не оптимизирует текст под детекторы, не имитирует опечатки и разговорные вставки и не обещает результата проверки. Цель — текст полезный, ясный и ваш, с честным происхождением.
Чем Clarity отличается от скиллов, которые убирают приметы ИИ?
Те скиллы чистят шаблонные фразы по спискам. Clarity сначала разбирает вопросы по существу: читателя, главную мысль и конкретику, а уже потом правит стиль и в контексте решает, считать ли найденный прием проблемой.
Есть ли у Clarity онлайн-версия?
Да, на clarity.addy.ie есть редактор в браузере: он ищет приметы ИИ-письма, считает читаемость и задает общие вопросы Clarity. Автор пишет, что черновик при этом не загружается на сервер. На сайте также лежат пошаговые руководства для Claude Code и Codex.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл для очистки текста от примет ИИ: чинит структуру художественной прозы и правит рабочие документы по правилам их жанра
Avoid AI Writing
avoid-ai-writing
Скилл находит в тексте типичные приметы машинного письма и переписывает его, есть режимы только проверки и правки файла на месте
Короткий скилл со строгими правилами, который вычищает из прозы шаблонные фразы и конструкции ИИ
Скилл находит в английской прозе приметы ИИ и точечно правит их; три Python-сканера работают отдельно, а команда teach учит голосу автора
Скилл разбирает набор статей автора и выводит воспроизводимый профиль стиля: язык, структуру, логику тем, работу с источниками и визуальную подачу
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Clarity (эта запись) | нет | 281 | |
| Stop Slop | нет | 18 266 | короткий свод правил, который вычищает шаблонные фразы ИИ, без интервью и режима разбора |
| Humanizer | нет | 59 836 | убирает приметы ИИ-письма по списку Википедии, а здесь упор на смысл, читателя и ваш материал |
| nopus | нет | 299 | плагин меряет сложность языка в ответах кодинг-агента и возвращает |
Коротко о README
README одновременно служит эссе о письме. Оно начинается с установки скилла и режимов, затем идут восемнадцать принципов в четырех блоках: полезное, ясное, свое и сборка текста. Вторая половина описывает сам скилл: состав репозитория, три способа работы, что дает каждый режим, проверку поведения через `evals` и запуск линтера.
Бейдж для README
Исходный SKILL.md
--- name: clarity description: "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." license: MIT metadata: version: "0.2.1" --- # Clarity Good prose gives a particular reader something worth carrying away. Generic model prose often fails before style enters the picture: it has no specific source, judgment, mechanism, image, or experience behind it. Fix that first. Do not optimize for an AI detector or promise a detector result. Do not manufacture typos, slang, anecdotes, uncertainty, opinions, or awkwardness. The goal is better writing with honest provenance. ## Choose a mode An explicit mode word wins: ```txt interview | write | draft | new Co-write from the author's supplied language. rewrite | edit | fix | humanize Rewrite an existing draft. review | critique | check Critique without rewriting or changing files. lint | stats Run diagnostics without changing prose. ``` Without a mode, infer from the request. Ask only when the user could reasonably mean either a review or a rewrite. Load only the reference the mode needs: ```txt Co-write references/interview.md Rewrite references/edit.md Review references/review.md, then references/edit.md as a pattern reference Lint scripts/strip_markdown.py and scripts/prose_stats.py ``` For essays, articles, newsletters, talks, speeches, narrative, fiction, or other authored long-form prose, also read `references/longform.md`. For academic, legal, medical, safety, reference, procedural, marketing, email, UI, speech,