writing-clearly-and-concisely
Набор рекомендаций по написанию технической документации, сообщений и пользовательского текста без лишних слов и штампов.
Суть
Что это за skill и зачем он нужен
Этот навык предоставляет практические правила из «The Elements of Style» Уильяма Странка и список типичных шаблонов AI‑текста, которых следует избегать. Он включает правила пунктуации, построения предложений, активного залога и удаления ненужных слов, а также рекомендации по работе с ограниченным контекстом: загрузка отдельного раздела (например, 03-elementary-principles-of-composition.md) вместо полного набора файлов. Всё содержимое представлено в виде Markdown‑файлов, без исполняемого кода.
Установка
Как установить
npx skills add https://github.com/softaworks/agent-toolkit --skill writing-clearly-and-conciselyСценарии
Когда использовать
Подходит
- Создание и редактирование README, технической документации и справочных материалов;
- Написание сообщений коммитов, описаний pull‑request и релиз‑ноутов;
- Формулирование сообщений об ошибках, подсказок UI и справочного текста;
- Подготовка отчетов, резюме и прочих объяснительных материалов для людей;
- Редактирование уже написанных текстов с целью повышения ясности и лаконичности
Не подходит
- Генерация исходного кода или скриптов, где требуются синтаксические проверки;
- Создание художественных произведений, где допускаются стилистические отклонения;
- Автоматический перевод текста без последующего человеческого контроля;
- Обработка бинарных файлов, изображений или иных не‑текстовых ресурсов
Доверие
Проверки безопасности
Проверка не нашла критичных проблем.
Проверка не нашла критичных проблем.
Низкий риск · проблем не найдено.
Предупреждений нет.
Оценка 93/100 · проанализировано 2 раздела.
Похожие