Ревью текстов по Writing Guidelines

Делает ревью документации и текстов по справочнику стиля Vercel, который скачивает при каждом запуске, и выдаёт находки в виде file:line. Для случаев, когда англоязычную документацию нужно проверить перед публикацией.

ДокументацияПак: Скиллы Vercelссылкаwriting-guidelines
Автор
Источник
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 и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Vercel

Правила производительности React и Next.js

Делает ревью и правки кода на React и Next.js по 70 правилам производительности от Vercel: водопады запросов, размер бандла, сервер, ре-рендеры. Для случаев, когда пишете или переделываете компоненты и загрузку данных.

Паттерны композиции в React

Делает компоненты React составными: вместо булевых пропсов — общий контекст, состояние в провайдере и явные варианты, плюс изменения React 19. Для случаев, когда у компонента слишком много флагов или собирается библиотека компонентов.

Лучшие практики React Native

Делает мобильный код на React Native и Expo быстрее по правилам Vercel: виртуализация списков, анимации transform и opacity, нативная навигация, expo-image, монорепозиторий. Для случаев, когда приложение тормозит или идёт ревью.

Анимации переходов в React

Делает анимации переходов на View Transition API в React: перетекание общих элементов, появление после Suspense, перестановку списков, сдвиги между страницами. Для случаев, когда в приложение на Next.js или React 19.3+ нужны переходы.

Деплой на Vercel от Vercel Labs

Делает деплой проекта на Vercel в превью: по состоянию проекта выбирает git push, деплой из CLI, привязку или временный деплой без аккаунта и возвращает ссылку. Для случаев, когда нужно выложить приложение и получить ссылку.

Vercel CLI с токенами

Делает деплой и управление проектом Vercel по токену доступа без входа через браузер: ищет токен, выкладывает превью, ведёт переменные окружения, логи и домены. Для случаев, когда агент работает в неинтерактивной среде.

Оптимизация затрат и скорости на Vercel

Делает аудит затрат и скорости проекта на Vercel: сначала метрики, затем отбор кандидатов по порогам, разбор только отмеченных маршрутов и проверенные рекомендации со ссылками. Для случаев, когда нужно урезать счёт или ускорить маршруты.

Ревью по Web Interface Guidelines

Делает ревью кода интерфейса по Web Interface Guidelines от Vercel, которые скачивает при каждом запуске, и выдаёт находки в виде file:line. Для случаев, когда нужно быстро проверить компоненты или страницы перед пулреквестом.