Vercel Skills CLI: как ставить, обновлять и удалять навыки для ИИ-агентов

Vercel Skills CLI помогает установить готовые инструкции для ИИ-агента. В этом руководстве вы поставите один навык, вызовете его в агенте и проверите на учебной странице. Затем сможете обновить или удалить его.

Навык (Agent Skill) — папка с файлом SKILL.md. В файле написано, когда и как агент должен выполнять определённую задачу; рядом могут находиться скрипты и примеры. CLI — программа, которой управляют командами в терминале. Она скачивает навык и размещает его там, где агент умеет его обнаруживать.

Руководство рассчитано на локальную работу на компьютере. Оно не устанавливает навыки в обычный веб-чат ChatGPT или Claude. Для первого примера используется Claude Code; ниже есть команды установки и способы вызова для Codex и Cursor.

Граница проверки. Команды и ограничения сверены с документацией версии 1.8.1. В командах указана именно эта версия: skills@1.8.1. Это версия установщика; содержимое навыка из ветки main может обновляться независимо. Просмотр списка, установка навыка и проверка установленных файлов дополнительно выполнены в отдельной тестовой папке на Linux с Node.js 24.22.1. Скриншоты ниже показывают реальный вывод CLI. Сквозной запуск навыка внутри авторизованного агента не проверялся. Ответ ИИ может отличаться от примеров, поэтому каждый этап сопровождается проверкой результата.

Что подготовить

Понадобятся интернет, Node.js с npm и npx, а также установленный агент с настроенным входом. Сам установщик Skills открыт под лицензией MIT; условия использования и оплата выбранного агента определяются его сервисом отдельно.

Откройте терминал

Терминал — окно, куда вводят команды и где читают результат их выполнения.

• Windows: откройте меню «Пуск», найдите PowerShell и запустите его без прав администратора.
• macOS: через Spotlight найдите приложение Terminal и откройте его.
• Linux: откройте приложение «Терминал» вашей системы.

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

Если работаете внутри WSL, удалённого сервера или контейнера, и Node.js, и агент, и навык должны находиться в том же окружении. Для первого знакомства используйте обычный локальный терминал.

Установите и проверьте Node.js

По требованиям Skills CLI нужен Node.js 22.20 или новее. Node.js запускает программы на JavaScript; npm доставляет пакеты, а npx позволяет запустить пакет без отдельной постоянной установки.

Сначала проверьте, что уже установлено:

node --version
npm --version
npx --version

Каждая команда должна вывести номер версии. Для Node.js подойдут, например, v22.20.0 и более новые совместимые версии; v22.19.0 ниже требования.

Если программы нет или Node.js слишком старый:

1. Откройте официальную страницу загрузки Node.js.
2. Выберите свою операционную систему и поддерживаемую LTS-версию, удовлетворяющую требованию выше.
3. На Windows скачайте установщик .msi, на macOS — .pkg и пройдите установку с обычными настройками, включая npm. На Linux выберите предложенный для вашей системы способ установки и выполните соответствующие инструкции страницы.
4. Закройте терминал, откройте заново и повторите три команды проверки.

Не продолжайте, пока все три программы не отвечают номером версии. Если PowerShell блокирует запуск npm.ps1 или npx.ps1, используйте npm.cmd и npx.cmd вместо npm и npx; менять политику безопасности всей системы для этого не требуется.

Подготовьте агента

Если Claude Code, Codex или Cursor у вас уже работает, повторная установка не нужна. Для основного примера проверьте Claude Code:

claude --version

Если команда не найдена и вы выбрали Claude Code, воспользуйтесь его официальной установкой. Следующие команды скачивают и запускают установщик Anthropic. Выберите только вариант для своей системы.

macOS, Linux или WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

После установки откройте новый терминал, повторите claude --version, затем запустите claude и завершите вход по подсказкам в браузере. Нужен поддерживаемый способ авторизации и оплаты; доступность сервиса зависит от региона и правил организации. Если вход не проходит, сначала решите эту проблему: установка навыка не даст доступ к самому агенту.

Завершите пробную сессию Claude Code командой /exit, чтобы вернуться к обычной строке терминала. Команды npx ниже вводятся именно там.

Первый результат: проверка учебной страницы

Установим web-design-guidelines. Этот навык читает код интерфейса, получает актуальные правила Vercel и выдаёт замечания с указанием файла и строки. Для его работы агенту нужны чтение файлов и доступ к странице правил в интернете.

1. Создайте отдельную папку

В Проводнике Windows или Finder macOS создайте в своей пользовательской папке каталог skills-demo. Здесь «проект» означает эту папку и находящиеся в ней файлы; готовое приложение не требуется.

Перейдите в неё в терминале. Для Windows PowerShell:

cd "$HOME\skills-demo"

Для macOS или Linux, если создали папку в домашнем каталоге:

cd "$HOME/skills-demo"

Если выбрали другое место, после cd укажите полный путь к своей папке в прямых кавычках. Проверьте расположение: в PowerShell выполните Get-Location, в macOS или Linux — pwd. Последняя часть пути должна быть skills-demo.

2. Подготовьте файл для проверки

Откройте эту папку в редакторе кода или простом текстовом редакторе. Создайте файл index.html и сохраните в него пример ниже. В Блокноте Windows при сохранении выберите тип «Все файлы», чтобы не получить index.html.txt; в TextEdit macOS сначала включите режим обычного текста. Не сохраняйте файл как документ Word или RTF.

В примере намеренно пропущена подпись поля. Это учебная ошибка, которую удобно искать при первой проверке.

<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Учебная форма</title>
</head>
<body>
  <main>
    <h1>Подписка на новости</h1>
    <form>
      <input type="email" placeholder="Ваш email">
      <button type="submit">Подписаться</button>
    </form>
  </main>
</body>
</html>

Проверьте файл командой Get-ChildItem в PowerShell или ls в macOS/Linux. В списке должен быть index.html. Открывать сайт на сервере или настраивать React для этого примера не нужно: навык проверяет исходный код.

3. Посмотрите доступные навыки

Из той же папки выполните:

npx skills@1.8.1 add vercel-labs/agent-skills --list

При первом запуске npx может попросить разрешить скачивание пакета skills@1.8.1. Проверьте название и подтвердите установку пакета. Это отдельно от установки навыков.

В результате должен появиться список навыков репозитория, в том числе web-design-guidelines. Флаг --list не устанавливает сами навыки, хотя CLI скачивает данные, нужные для просмотра. Если нужного имени нет, остановитесь и проверьте источник; не подставляйте похожее название наугад.

4. Установите один навык

Для Claude Code:

npx skills@1.8.1 add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code

Здесь --skill выбирает навык, -a — агента. Без -g установка относится к текущему проекту. Эти параметры не отключают все вопросы установщика.

Если появится выбор области, оставьте проектную установку. При выборе способа размещения используйте рекомендованный симлинк (Symlink): это ссылка из папки агента на общую копию навыка. Если система не позволяет создавать такие ссылки, выберите Copy или повторите команду с --copy.

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

Если запустить команду без --skill web-design-guidelines, CLI предложит выбрать навык из списка. На скриншоте отмечен только нужный: стрелки перемещают выделение, пробел ставит отметку, Enter подтверждает выбор. С указанным выше --skill этот экран пропускается.

Выбор одного навыка в Skills CLI 1.8.1, Linux. У web-design-guidelines стоит отметка, а Select All (1/9) показывает, что выбран один навык из девяти. Состав репозитория со временем может измениться.

5. Проверьте установку

npx skills@1.8.1 list -a claude-code

В списке должен присутствовать web-design-guidelines. В папке проекта для Claude Code ожидается путь .claude/skills/web-design-guidelines/SKILL.md; каталог навыка может быть ссылкой. Папки, начинающиеся с точки, могут быть скрыты в файловом менеджере.

Проверка после установки в тестовой папке на Linux: list показывает навык, путь и агента Claude Code. Дополнительная команда ls подтверждает наличие SKILL.md в каталоге навыка; в PowerShell для просмотра файлов используйте Get-ChildItem с тем же путём.

Список подтверждает наличие установленного навыка, но не запуск самого агента. Следующий шаг проверяет, может ли агент его прочитать и применить.

6. Вызовите навык в Claude Code

Находясь в skills-demo, запустите:

claude

Если агент попросит подтвердить доверие к рабочей папке, проверьте путь: это должна быть созданная вами учебная папка. В чате Claude Code введите / и найдите web-design-guidelines. По правилам вызова навыков Claude Code его можно вызвать по имени, передав файл:

/web-design-guidelines index.html

Это команда внутри чата агента. В обычный PowerShell или Terminal её вводить не нужно. Если агент просит разрешить чтение файла и загрузку правил, сверяйте запрошенные пути и адрес с инструкцией навыка. Для проверки учебного файла не нужны доступ к секретам или публикация проекта.

Если хотите сразу задать границы проверки, после выбора навыка добавьте запрос.

Промпт:

Проверь index.html с помощью web-design-guidelines. Сначала прочитай инструкцию навыка и получи правила по указанной в ней ссылке.

Файлы пока не изменяй. Покажи замечания с указанием файла и строки. Если правила не удалось загрузить, прямо сообщи об этом и не выдавай проверку по памяти за выполненный запуск навыка.

7. Проверьте результат

В правилах Vercel есть требование подписи для полей формы: label или aria-label. В учебном файле такой подписи нет. Ожидаемый результат — замечание об этом поле с указанием index.html и строки. Точная формулировка и остальные замечания могут различаться.

Проверьте три вещи:

• Агент прочитал установленный SKILL.md и получил правила либо честно сообщил, что загрузка не удалась.
• В отчёте есть конкретные места в вашем файле, которые можно открыть и проверить.
• Агент не изменил файл, поскольку вы попросили только проверку.

Предложение исправления можно проверить на одном поле:

<label for="email">Электронная почта</label>
<input id="email" name="email" type="email" autocomplete="email" placeholder="name@example.com…">

Замените исходный input этими двумя строками, сохраните файл и повторно вызовите навык. Замечание об отсутствии подписи у этого поля должно исчезнуть; другие замечания могут остаться. Отчёт ИИ не заменяет тестирование интерфейса в браузере и проверку доступности.

Если вы используете Codex или Cursor

Подготовка Node.js и учебного файла остаётся прежней. Выберите одну команду под свой агент; ставить навык сразу во все агенты не требуется.

Codex:

npx skills@1.8.1 add vercel-labs/agent-skills --skill web-design-guidelines -a codex

Откройте локальную сессию Codex в skills-demo. В Codex CLI или IDE-расширении откройте /skills либо введите $ и выберите навык. Затем отправьте $web-design-guidelines Проверь index.html, файлы не изменяй. Такой способ указан в документации Codex. Если навык не появился, перезапустите Codex.

Cursor:

npx skills@1.8.1 add vercel-labs/agent-skills --skill web-design-guidelines -a cursor

Откройте папку skills-demo в Cursor, создайте чат Agent, введите / и найдите web-design-guidelines. После выбора попросите проверить index.html без изменений. Ручной вызов описан в документации Cursor. Если навык не обнаружен, заново откройте проект или перезапустите Cursor.

Во всех вариантах отдельно проверяйте загрузку правил и чтение файла. В инструкции этого навыка указан инструмент WebFetch; у другого агента может быть свой способ обращения к интернету. Если подходящий инструмент недоступен, полный сценарий не выполнен, даже когда навык есть в списке.

Только этот проект или все ваши проекты

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

npx skills@1.8.1 add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code -g

-g меняет место установки на пользовательскую папку. Это не установка для всех пользователей компьютера и не автоматическая доставка в облачные или удалённые сессии.

Пути, которые использует CLI, перечислены в таблице агентов версии 1.8.1. ~ обозначает домашнюю папку пользователя; относительные пути отсчитываются от проекта.

Общую .agents/skills/ могут читать несколько агентов. Поэтому установка в эту папку не означает, что навык будет виден исключительно агенту, указанному в -a.

Симлинки ведут к общей копии; --copy создаёт отдельные копии. Если передаёте проект команде через Git, включайте нужные файлы навыков и skills-lock.json, проверяйте, куда ведут ссылки, и исключайте секреты. После получения проекта на другом компьютере отдельно проверьте восстановление и обнаружение навыка: наличие одной ссылки в Git этого не гарантирует.

Полезные сценарии

Проверить страницу перед передачей заказчику

На входе: проект сайта и конкретная страница или компонент. Установите web-design-guidelines в проект, явно вызовите его для нужных файлов и сначала запросите только отчёт. Разберите замечания, согласуйте исправления и повторите проверку после изменений.

Результат: список проверяемых проблем с местами в коде. Навык не подтверждает работу всей страницы, серверной части или отправки формы; это проверяется отдельно.

Использовать одну процедуру в разных проектах

На входе: навык, который уже оказался полезен на учебной задаче. Проверьте его содержимое, поставьте глобально с -g, затем откройте другой проект и убедитесь, что агент видит навык и применяет его к нужным файлам.

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

Дать команде проверяемый набор навыков

На входе: общий репозиторий проекта. Согласуйте нужные навыки, сохраните их файлы и файл учёта skills-lock.json, проверьте установку на отдельной копии проекта. Перед обновлением посмотрите, какие инструкции и скрипты изменились.

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

Обновить и удалить навык

Следующие команды выполняются в обычном терминале. Если вы ещё в Claude Code, сначала введите /exit.

Посмотреть установленные навыки

Из папки проекта:

npx skills@1.8.1 list

Отдельно глобальные:

npx skills@1.8.1 list -g

В версии 1.8.1 список сопоставляет проектные файлы с skills-lock.json и может отмечать изменённые, неучтённые или отсутствующие навыки. Значение этих состояний описано в справочнике команд.

Проверить обновления

npx skills@1.8.1 check

Команда не переустанавливает навыки. В версии 1.8.1 она также сообщает о локальных изменениях проектных навыков. Код завершения 1 может означать найденное обновление или локальное изменение; читайте сообщение, прежде чем считать это технической ошибкой.

Обновить выбранный навык

Только в текущем проекте:

npx skills@1.8.1 update web-design-guidelines -p

Только в глобальной установке:

npx skills@1.8.1 update web-design-guidelines -g

update без имени обновляет набор навыков; -p явно выбирает проект, -g — глобальную область. Обновление навыков и обновление самой программы Skills CLI — разные действия. Чтобы перейти с закреплённой версии CLI на новую, сначала ознакомьтесь с её релизом и измените номер после skills@.

Удалить учебный навык

Из проекта Claude Code:

npx skills@1.8.1 remove web-design-guidelines -a claude-code

Из глобальной установки Claude Code:

npx skills@1.8.1 remove web-design-guidelines -a claude-code -g

Для Codex или Cursor замените значение -a на codex или cursor. Проверьте итог через list с тем же агентом и областью, затем начните новую сессию агента. Удаление файлов не стирает инструкции, уже прочитанные в старом чате.

npx skills@1.8.1 remove --skill '*' -a cursor

В версии 1.8.1 массовое удаление через --skill '*' или --all ограничено записями файла учёта; неучтённые папки пропускаются. Для удаления неучтённого навыка нужно явно указать его имя. Поведение старых версий может отличаться.

Найти и попробовать другой навык

Поиск по слову:

npx skills@1.8.1 find typescript

Интерактивный поиск:

npx skills@1.8.1 find

Поиск среди репозиториев одного владельца:

npx skills@1.8.1 find react --owner vercel

Каталог skills.sh ранжирует навыки по статистике установок. Популярность не подтверждает пригодность для вашей задачи или безопасность: до установки откройте исходники и зависимости.

Для разовой пробы предусмотрен use:

npx skills@1.8.1 use vercel-labs/agent-skills@web-design-guidelines --agent claude-code

По документации команды она скачивает выбранный навык во временную папку и запускает поддерживаемого агента с подготовленным промптом. Без --agent печатает промпт. Постоянная установка в папку навыков не требуется, но агент всё равно может выполнять действия по инструкции. Используйте те же проверки и ограничения, что для установленного навыка.

Другие источники и приватные репозитории

CLI принимает GitHub, GitLab, Azure Repos, Git-адреса, локальные папки и прямые ссылки на файлы или архивы. Полные форматы и ограничения есть в справочнике установки.

Можно указать путь к конкретному навыку:

npx skills@1.8.1 add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

Или локальную папку, если она существует внутри текущего каталога:

npx skills@1.8.1 add ./my-local-skills

Для прямых загрузок документация задаёт предел 10 МиБ на скачивание, 25 МиБ на распакованное содержимое и 1000 файлов. Не увеличивайте эти пределы, пока не проверили источник.

В версии 1.8.1 источник прямой загрузки учитывается для последующего обновления и восстановления. Ссылки с параметрами запроса или встроенными учётными данными не записываются в файл учёта; для повторной установки понадобится новая ссылка. Не помещайте секретные ссылки и токены в общий репозиторий.

Для приватного репозитория заранее настройте доступ через Git, GitHub CLI или SSH. Skills использует доступные способы авторизации. Он не извлекает сохранённый токен GitHub CLI через gh auth token, но умеет использовать явно заданные переменные GITHUB_TOKEN и GH_TOKEN. Для публичного учебного репозитория личный токен обычно не нужен.

Навыки из Notion

С версии 1.7.0 CLI принимает наборы навыков и отдельные страницы Notion, оформленные как навыки. Обычная доступная страница не становится навыком автоматически.

Для этого отдельно установите Notion CLI по его официальной инструкции, выполните ntn login и завершите вход с личным токеном. Рабочее пространство должно разрешать такие токены. Затем можно открыть список доступных наборов:

npx skills@1.8.1 add notion

Устанавливайте только нужный набор и проверяйте список его навыков: команда может поставить все навыки выбранного набора. Для одной страницы передайте её полный URL после add. Доступ определяется правами Notion. Подробнее об устройстве источника — в материале «Notion открыла Skills API: навыки вместе с файлами».

Установленная локальная копия не становится автоматически синхронизируемой с каждой правкой страницы. Её обновление нужно проверять отдельно.

Дополнительные возможности

Установка без подтверждений

Когда вы уже проверили источник и область установки, можно отключить вопросы флагом -y. Например, поставить один навык глобально в Claude Code:

npx skills@1.8.1 add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code -g -y

Это не делает установку из изменяемой ветки воспроизводимой. Для автоматических проверок проекта (CI) отдельно закрепляйте источник навыка, контролируйте файл учёта и проверяйте результат восстановления. Флаг --all ставит все навыки во все целевые агенты без вопросов; новичку для первого запуска он не нужен.

Создание собственного навыка

npx skills@1.8.1 init my-skill

Команда создаёт папку my-skill и файл SKILL.md. Откройте его в редакторе: в YAML-заголовке между строками --- укажите name и description, ниже опишите шаги и проверку результата. Для нового переносимого навыка используйте в имени строчные латинские буквы, цифры и дефисы; описание должно говорить, какую задачу решает навык и когда его выбирать.

Сначала установите локальную папку и проверьте навык на конкретной задаче. Для распространения разместите его в Git-репозитории или по прямой ссылке. CLI обнаруживает SKILL.md в корне и в стандартных каталогах, включая skills/ и папки агентов. В каталогах навыков поиск ограничен глубиной до трёх уровней; собственные каталоги задаются полем paths в корневом skills.sh.json. Формат и примеры есть в руководстве по созданию навыков.

Поле metadata.internal: true скрывает навык из обычного обнаружения CLI. Переменная INSTALL_INTERNAL_SKILLS=1 разрешает его показ и установку. Это удобство для черновиков, а не защита доступа: файлы публичного репозитория остаются публичными.

Совместимость агентов

Общий формат SKILL.md помогает переносить инструкции, но не гарантирует одинаковое выполнение. Проверяйте программы, сетевой доступ, команды и разрешения, нужные самому навыку.

Таблица совместимости CLI отдельно перечисляет поддержку хуков — действий на события агента, context: fork — запуска в отдельном контексте, и allowed-tools — настройки инструментов. Эти поля нельзя считать универсальными разрешениями или гарантией переноса. Адаптация разобрана в руководстве «Перенос скилла из Claude в Codex».

Экспериментальная синхронизация и восстановление

Эти режимы не нужны для первого результата. Их названия и поведение могут меняться:

• experimental_sync получает навыки из установленных npm-зависимостей и поля skills файла package.json.
• experimental_install восстанавливает поддерживаемые источники из skills-lock.json и в версии 1.8.1 создаёт размещение для выбранных агентов. install и i без источника служат его псевдонимами.

Начните с просмотра плана без изменений:

npx skills@1.8.1 experimental_sync --dry-run
npx skills@1.8.1 experimental_install --dry-run

В среде CI по умолчанию действует --frozen-lockfile: содержимое должно соответствовать файлу учёта. Для навыков из npm сначала нужны установленные зависимости проекта. Перед рабочим запуском изучите условия синхронизации и восстановления: эти команды могут менять набор навыков, а восстановление — заменять отличающиеся файлы.

Безопасность и телеметрия

skills.sh сообщает о проверках на вредоносное содержимое, но не гарантирует качество и безопасность каждого навыка. Проверяйте источник перед установкой и после существенных обновлений. Не соглашайтесь на доступ к ключам, отправку данных, удаление или публикацию только потому, что это просит инструкция навыка.

Согласно описанию телеметрии, CLI собирает анонимные данные использования. Идентификаторы GitHub-репозиториев и навыков отправляются только после подтверждения публичности репозитория. Для других удалённых источников идентификаторы могут попадать в статистику, поскольку их видимость нельзя проверить через GitHub.

Переменные DISABLE_TELEMETRY=1 и DO_NOT_TRACK=1 отключают и телеметрию, и запросы проверки безопасности CLI. Это не блокирует обращения в интернет, которые затем выполняет сам агент или скрипт навыка.

macOS/Linux — отключение для одной команды:

DISABLE_TELEMETRY=1 npx skills@1.8.1 list

Windows PowerShell — отключение в текущем окне терминала:

$env:DISABLE_TELEMETRY = "1"
npx skills@1.8.1 list

Закрытие этого окна PowerShell завершит действие установленной в нём переменной. Не путайте отключение статистики с проверкой безопасности самого навыка.

Если что-то не работает

Старая команда npx add-skill устарела; переход на интерфейс npx skills описан в анонсе версии 1.1.1.

Следующий шаг

Возьмите один файл своего проекта и повторите цикл: явный вызов навыка → проверяемые замечания → согласованное исправление → повторная проверка. Для распределения постоянных правил и отдельных процедур пригодится руководство:

• База знаний: Файлы контекста для ИИ-агентов: AGENTS.md, SKILL.md, DESIGN.md

Если в команде несколько агентов и проектов, полезно согласовать набор навыков, порядок обновлений и способы проверки результата. Это можно разобрать на вашем рабочем процессе.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov