writing-clearly-and-concisely
Помогает писать ясный и лаконичный текст: документацию, сообщения коммитов, ошибки, объяснения, отчеты и UI-текст. Применяет правила Струнка для более профессионального стиля.
AIsoftaworks
official
Документы
★ 2.5k
Что делает навык
Навык помогает писать ясный и лаконичный текст для людей, применяя правила книги Струнка «Элементы стиля» и избегая характерных для ИИ шаблонных конструкций. Он решает задачу улучшения читаемости, профессионализма и конкретности технических и пользовательских текстов.
Когда применять
- Написание документации, файлов README и технических объяснений
- Создание сообщений коммитов, описаний pull request и комментариев в коде
- Формулирование сообщений об ошибках, UI-текста, справочных сообщений
- Подготовка отчетов, сводок и любых других объяснений для людей
- Редактура существующего текста для повышения его ясности
Как работает
- Определить, что текст предназначен для чтения человеком, и выбрать соответствующий раздел из папки elements-of-style
- Загрузить файл с правилами (рекомендуется 03-elementary-principles-of-composition.md для большинства задач)
- Применить правила Струнка: использовать активный залог, позитивные формулировки, конкретный язык и устранять лишние слова
- Исключить типичные для ИИ паттерны: пафосные прилагательные, пустые фразы на -ing, перегруженное форматирование
- При нехватке контекста написать черновик, передать его субагенту вместе с файлом раздела для копирайтинга и получить исправленную версию
Примеры запросов агенту
Проверь это сообщение коммита на соответствие правилам лаконичности и избежания ИИ-шаблонов
Переформулируй это описание ошибки в UI, чтобы оно было конкретным и не содержало пафосных прилагательных
Отредактируй этот раздел документации, применив активный залог и удалив лишние слова
Описание составлено по SKILL.md навыка, сверено 07.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «writing-clearly-and-concisely» из репозитория:
# https://github.com/softaworks/agent-toolkit
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r writing-clearly-and-concisely/ ~/.claude/skills/writing-clearly-and-concisely/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.