writing-clearly
Пишет и редактирует русский текст ясно и кратко. Убирает канцеляризмы, пассивный залог, абстракции и AI-штампы. Используй при написании документации, README, commit-сообщений, UI-текстов, отчётов, писем, или когда просят упростить текст, убрать воду, проверить на канцеляризмы.
Resources
1Install
npx skillscat add nikitacodesave/writing-clearly/writing-clearly Install via the SkillsCat registry.
Ясное письмо на русском
Принципы Норы Галь («Слово живое и мёртвое») и Максима Ильяхова («Пиши, сокращай»).
Краткая памятка
| Заменяй | На |
|---|---|
| Пассивный залог | Активный залог |
| Отрицания | Утверждения |
| Абстракции | Конкретные числа/факты |
| Отглагольные (-ание, -ение) | Глаголы |
| Слова-паразиты | Ничего |
| Канцеляризмы | Живой язык |
Порядок работы
- Напиши или получи черновик
- Примени правила из references/style-guide.md
- Проверь по чек-листу в конце того файла
- Убедись, что нет AI-штампов
Примеры
Было:
В рамках данного проекта была осуществлена разработка системы, которая обеспечивает высокую скорость обработки запросов.
Стало:
Мы разработали систему, которая отвечает за 50 мс.
Было:
Следует отметить, что данное решение имеет ключевое значение для пользователей.
Стало:
Это решение сокращает время ожидания втрое.
Главные правила
Активный залог: «Сервер обрабатывает», а не «обрабатывается сервером»
Утверждения: «Забыл», а не «не помнил»
Конкретика: «12 000 пользователей», а не «много пользователей»
Глаголы: «Проверить», а не «осуществить проверку»
Без воды: Удаляй «следует отметить», «ни для кого не секрет», «в целом»
Без канцелярита: «Сейчас», а не «на сегодняшний день»
Без AI-штампов: Избегай «играет ключевую роль», «уникальный», «инновационный»
Подробное руководство
Полные правила с примерами и чек-лист: references/style-guide.md
Categories
Install
npx skillscat add nikitacodesave/writing-clearly/writing-clearly Install via the SkillsCat registry.