writing-clearly-and-concisely — скилл для Claude Code: ясный текст

Что делает writing-clearly-and-concisely

Скилл включается, когда агент пишет текст для человека: документацию, README, описания пул-реквестов, сообщения коммитов, текст ошибок, подписи в интерфейсе, отчёты. Внутри — свод правил из «The Elements of Style» Уильяма Странка-младшего: активный залог, утвердительные формулировки, конкретные слова, минимум лишних слов, тема в начале абзаца, значимое слово в конце предложения. Отдельный раздел перечисляет приметы машинного текста, которых стоит избегать: напыщенные эпитеты, пустые обороты с деепричастиями, рекламные прилагательные, заезженная лексика вроде «leverage» и «delve», избыток списков и эмодзи.

Правила разложены по четырём файлам в папке elements-of-style/: грамматика и пунктуация, принципы композиции, оформление заголовков и цитат, слова и выражения, которые часто путают. Для большинства задач хватает одного файла про композицию — он и покрывает активный залог, конкретность и сокращение. Есть и приём для экономии контекста: черновик пишется как обычно, а на вычитку отправляется субагент с одним нужным разделом, а не со всем набором.

Скилл ничего не проверяет автоматически и не запускает линтер. Он работает как инструкция для модели, поэтому результат зависит от того, какой текст вы поручили написать.