Ревью текстов по Writing Guidelines
Делает ревью документации и текстов по справочнику стиля Vercel, который скачивает при каждом запуске, и выдаёт находки в виде file:line. Для случаев, когда англоязычную документацию нужно проверить перед публикацией.
writing-guidelines- Автор
- Vercel
- Источник
- vercel-labs/agent-skills/skills/writing-guidelines @ 1a2c79d
- Лицензия
- не указана
Об этом скилле
Что делает
Скилл проверяет документацию и другие тексты на соответствие справочнику по стилю Vercel. Как и его близнец для интерфейсов из этого пака, правил он с собой не несёт. При каждом запуске агент скачивает их из command.md в ветке main отдельного репозитория vercel-labs/writing-guidelines, читает файлы или маску, которые вы назвали (или спрашивает, какие), и сверяет каждый со всеми правилами. Находки он выводит по файлам, в кликабельном формате file:line.
README репозитория насчитывает больше восьмидесяти правил. Планирование: план материала, заявленный тип контента, заголовок в форме вопроса пользователя. Голос: действительный залог, обращение на «you», без «easy», «simple» и «quick». Тон по типу материала — от туториала до разбора неполадок. Заголовки — с заглавной только первое слово. Код: метки языка, TypeScript первым, компонент <Steps/>, ограничения в 80 колонок и 25 строк. Единицы вроде 64 KB и 200 ms. Типографика: никаких длинных тире как знака препинания, типографские кавычки, символ многоточия. Без жёстких переносов строк в исходнике. Завершают список страницы с ценами, работа с ИИ и ревью пулреквестов.
Когда включать и когда не надо
Для англоязычных страниц документации, руководств и README перед публикацией, когда нужен построчный список стилистических проблем, а не переписанный текст.
Правила — внутренний стиль Vercel: <Steps/>, метаданные с типом контента и запрет длинного тире подходят их документации и могут не подойти вашей, так что часть находок придётся отбросить. Написаны они для английского, а не для русского. Скилл сообщает о проблемах, но ничего не правит. Нужны доступ в сеть и инструмент загрузки страниц (в SKILL.md назван WebFetch), а раз правила не привязаны к версии, результат может поменяться вместе со справочником.
Как поставить и вызвать
Этот скилл мы не копируем: лицензия не указана, текста лицензии в репозитории нет. Ставьте его из репозитория Vercel по кнопке к исходнику; установщик из README — npx skills add vercel-labs/agent-skills, а с --skill writing-guidelines встанет только этот скилл. Передайте файл или маску:
- Claude Code:
/writing-guidelinesили попросить скилл по имени. - Codex:
$writing-guidelines. - Cursor: наберите
/в чате Agent и выберитеwriting-guidelines.
Пример: /writing-guidelines content/docs/getting-started/*.mdx
Чем отличается от похожих
Написание README и Документация HTTP API пишут документацию по коду и проверяют каждую команду и пример; этот скилл проверяет стиль уже готового текста. Совместное написание документов собирает документ вместе с вами через вопросы и проверку на читателе. Тексты для агентов: скиллы и AGENTS.md — для текстов, которые читает агент. Ревью по Web Interface Guidelines применяет тот же механизм к коду интерфейса.
Установка
Скилл не скопирован в каталог: в репозитории автора нет текста лицензии. Установите его оттуда.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel