NBJ Write Clearly — скилл
Скилл правит и проверяет техническую документацию по принципам Google Developer Documentation Style Guide, не трогая факты.
- 120 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Скилл состоит из инструкций и справочных файлов без запуска кода.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/nbj-write-clearlyОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл состоит из инструкций и справочных файлов без запуска кода.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
NBJ Write Clearly ведет агента через правку или проверку документации: ответ читателю идет первым, действующие лица названы, условия стоят перед шагом. Команды, имена файлов, API, названия интерфейса, модальные глаголы и цитаты сохраняются без изменений. Скилл умеет писать с нуля, переписывать черновик и только аудировать без переделки. Короткий `SKILL.md` содержит порядок работы, а справочные файлы подключаются по необходимости и ведут на нужные страницы руководства Google.
Для кого. Техническим писателям и разработчикам, которые пишут инструкции, релизные заметки и тексты интерфейса и хотят проверки без потери смысла.
Подходит, если
- Черновик README с перепутанным порядком шагов нужно привести к понятной процедуре.
- Перед релизом проверяют заметки, не переписывая их, и получают список главных проблем.
- Текст интерфейса сокращают, оставляя названия кнопок как есть.
- Объяснение API для зарубежной аудитории упрощают без потери точности.
Не подходит, если
- Пишется реклама, юридический, академический или художественный текст.
- Нужен единый брендовый голос: скилл ориентирован на руководство Google.
- Нужна проверка орфографии на русском: опора на английское руководство.
Пример запроса к агенту
Используй nbj-write-clearly и проверь эту процедуру установки: перечисли главные проблемы ясности, но текст не переписывай.Ограничения
Скилл неофициальный и не воспроизводит все руководство Google: он оформляет основные принципы, а редкие случаи отправляет на живые страницы. Автор проверил 70 страниц руководства в августе 2026. Основной язык правил английский. Последний коммит август 2026. Навык не заменяет редактора и служит помощником: стилистические решения по продукту, терминам и аудитории остаются за автором. Основной язык правил и примеров английский, поэтому для русских текстов результат придется дополнительно вычитывать вручную.
Как отключить. Удалите папку `nbj-write-clearly` из `~/.codex/skills/` или `~/.agents/skills/`, затем начните новую задачу, чтобы агент обновил список скиллов.
Частые вопросы
Как вызвать скилл?
Назовите его в запросе, например `$nbj-write-clearly`, либо оставьте выбор агенту: описание подскажет подходящие задачи, документацию, процедуры и релизные заметки.
Что скилл не меняет?
Факты, оговорки, команды, имена файлов, названия API и продуктов, подписи интерфейса, цитаты и модальные глаголы остаются как были.
Можно ли только проверить текст?
Да. Попросите аудит без переписывания, и агент выдаст самые серьезные проблемы ясности.
Что внутри репозитория?
`SKILL.md`, справочник `guide.md`, индекс официальных страниц `official-index.md`, файл для OpenAI и скрипт `scripts/check.sh`.
Чем это не универсальный упроститель?
Навык решает, что сохранить, что менять и когда остановить правку, а не сокращает все подряд.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл правки текста: убирает шаблонные обороты ИИ и сохраняет словарь, ритм и резкость автора, а не выравнивает стиль.
Скилл учит агента писать документацию и ответы простым английским по правилам ASD-STE100: короткие фразы, один термин, условие перед командой
Написание научных статей
Research Paper Writing
Скилл для написания и правки статей по ML, CV и NLP: структура разделов, связность абзацев и самопроверка глазами рецензента
Скилл для китайских технических текстов: правит документацию, интерфейсные строки и описания API, держит факты и проверяет выдачу линтером
Скилл переписывает плотный и двусмысленный английский по правилам упрощенного технического языка ASD-STE100, чтобы текст не мог прочитать неправильно другой аге
Правила письма Струнка 1918 года для агента: скилл применяет их к документации, коммитам и сообщениям об ошибках
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| NBJ Write Clearly (эта карточка) | нет | 120 | |
| technical-writing | нет | 219 | общий набор правил по техническому письму; этот навык построен на руководстве Google и защищает факты и голос автора |
| zh-tech-writing | нет | 419 | правила технического письма на китайском; здесь английское руководство Google с режимом аудита без правки |
Коротко о README
Источник вдохновения — идея превратить руководство Google в навык для агента. Сравнение с кандидатами и тест описаны в `EVALUATION.md`.