Руководство

skills.sh: установка навыков для нескольких ИИ-агентов

Как с помощью CLI skills.sh устанавливать и сопровождать навыки для Codex, Claude Code и других агентов для программирования, не дублируя инструкции.

Если вы пользуетесь несколькими агентами для программирования, копирование одних и тех же инструкций в отдельные директории Claude Code, Codex, Cursor и OpenCode быстро превращается в беспорядок. Копии расходятся, и становится трудно понять, какой версии следует агент.

skills.sh — это каталог, где можно найти навыки (skills) для агентов. Его CLI skills с открытым исходным кодом берёт на себя практическую часть: выбирает навыки из репозитория, устанавливает их для одного или нескольких агентов, а позже обновляет или удаляет.

Короткий ответ

Для начала выведите список навыков в репозитории, ничего не устанавливая:

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

Затем установите один навык для тех агентов, которые должны им пользоваться:

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent claude-code \
  --agent codex

Чтобы сделать этот навык доступным для всех агентов, которые поддерживает CLI, передайте подстановочный знак в кавычках — иначе оболочка его раскроет:

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent '*'

Есть и гораздо более широкая команда:

npx skills add vercel-labs/agent-skills --all

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

Что устанавливается

Навык агента — это директория, в которой есть как минимум файл SKILL.md. В этом файле указаны имя, описание, по которому агент решает, когда активировать навык, и сами инструкции. Навык может также содержать исполняемые скрипты, справочные материалы и ресурсы. Полная структура описана в спецификации Agent Skills.

CLI skills знает проектные и глобальные директории десятков агентов для программирования. Например, для установки Codex на уровне проекта он использует .agents/skills/, а для Claude Code — .claude/skills/. Он может создавать символические ссылки из этих директорий агентов на одну каноническую копию навыка. Так инструкции остаются согласованными, а одно обновление сразу действует для нескольких агентов.

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

Осознанно выбирайте область установки: проект или глобально

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

Добавляйте --global (или -g) только для личного рабочего процесса, который должен действовать во всех проектах:

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent codex \
  --global

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

Каталог помогает найти навык, но не доказывает его качество

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

Перед установкой публичного навыка:

  1. Откройте его исходный репозиторий и полностью прочитайте SKILL.md.
  2. Изучите файлы, на которые он ссылается, и каждый скрипт, который навык может выполнить.
  3. Проверьте лицензию, активность сопровождения, зависимости, сетевой доступ и примечания о совместимости.
  4. Поищите инструкции, которые противоречат версиям в вашем проекте или существующим правилам в AGENTS.md.
  5. Опробуйте навык на одном проекте и одной воспроизводимой задаче, прежде чем делать его глобальным или устанавливать для всех агентов.

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

Анонимную телеметрию CLI можно отключить для отдельной команды с помощью задокументированной переменной окружения:

DISABLE_TELEMETRY=1 npx skills add vercel-labs/agent-skills --list

Больше навыков — не обязательно лучше агент

Установка навыка не расширяет базовые возможности модели. Она даёт модели дополнительные инструкции и ресурсы. Полезные инструкции могут сделать специализированный рабочий процесс надёжнее, а нерелевантные или устаревшие — расходовать контекст, мешать хорошему подходу или противоречить репозиторию.

Первые данные неоднозначны. Недавний бенчмарк навыков для разработки ПО показал в среднем лишь 1,2% улучшения по 49 публичным навыкам. Тридцать девять из них не повысили долю успешно решённых задач, а три её снизили. Более широкое исследование SkillsBench обнаружило заметный средний прирост в нескольких областях, но также и отрицательные результаты на некоторых задачах; кроме того, сфокусированные навыки работали лучше, чем исчерпывающая документация.

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

Используйте самый простой механизм, который решает задачу

Задача С чего лучше начать
Воспроизводимая процедура для конкретного инструмента со вспомогательными файлами Сфокусированный навык проекта
Личный рабочий процесс во многих репозиториях Один проверенный глобальный навык
Правила, которым все участники и агенты должны следовать всегда Версионируемые инструкции проекта, например AGENTS.md
Одна необычная задача Прямой промпт с нужным контекстом
Детерминированная политика или проверка Скрипт, тест, форматтер или правило CI
Старые, общие или противоречивые инструкции Никакого навыка, пока инструкции не исправлены

Такое разграничение не даёт библиотеке навыков превратиться во вторую, менее заметную систему конфигурации. Навыки полезнее всего для процедурных знаний, которые агент должен загружать, только когда появляется подходящая задача. Постоянным командам и границам для всего репозитория место в сфокусированном файле инструкций; данные исследований и компактный шаблон — в руководстве что писать в AGENTS.md и CLAUDE.md.

Поддерживайте установленные навыки в порядке

CLI предоставляет обычные команды для управления жизненным циклом:

# Show project and global skills
npx skills list

# Update one installed skill
npx skills update web-design-guidelines

# Remove it
npx skills remove web-design-guidelines

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

Разумный подход по умолчанию — узкий: устанавливайте один проверенный навык в один проект для тех агентов, которым он нужен. Расширяйтесь до --agent '*', глобальной установки или --all только после того, как рабочий процесс заслужит такой охват.

Часто задаваемые вопросы

Может ли skills.sh установить один навык сразу для Codex и Claude Code?

Да. Передайте CLI skills имена обоих агентов, например --agent codex --agent claude-code. CLI устанавливает каноническую копию и может создать на неё ссылки в тех директориях навыков, где их ожидает каждый агент.

Как установить навык для всех поддерживаемых агентов?

Используйте --agent '*' вместе с конкретным --skill. Более широкий параметр --all без запросов подтверждения устанавливает все найденные навыки для всех агентов, поэтому сначала проверьте источник.

Безопасно ли устанавливать навыки из skills.sh?

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

Поделиться руководством