Перейти к содержанию

Установка и размещение скилов

Заметка основана на онбординг-докладе про скилы с богатым практическим опытом докладчика (Сергей Будяев, отвечает за продуктовое развитие внутренних кодинговых агентов в Яндексе). Ниже — операционная выжимка по двум вопросам: чем ставить скилы и куда их класть.

Установка: кроссагентная утилита npx skills

По опыту докладчика, самый удобный способ установки — JS-утилита npx skills (от команды vercel-labs, та же экосистема, что и каталог skills.sh). Она ставит скил по ссылке на репозиторий и работает интерактивно: сама определяет, какие кодинговые агенты у вас установлены, предлагает выбрать целевого агента и спрашивает способ размещения — симлинк (рекомендуется: единый источник правды и простое обновление) или копирование. Поддерживает уровень проекта и глобальный уровень (флаг -g) и десятки агентов. Главный плюс — она «знает, куда что положить», и снимает ручную возню с путями.

При этом у каждого агента есть и свой штатный способ установки; если не уверены — можно прямо спросить агента, куда класть скилы.

Размещение: своя папка Claude vs универсальная .agents/skills

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

  • Claude понимает скилы только в своих папках~/.claude/skills (личные) и .claude/skills (командные, через git). Докладчик считает это минусом: при переключении между агентами или в смешанной команде хочется единое, универсальное место.
  • Универсальная папка .agents/skills (стандарт Agent Skills) поддерживается Codex, OpenCode и Cursor. Рекомендация команды: если вы не на Claude или используете несколько агентов — складывайте скилы именно туда; тогда при переключении агентов или в мультиагентном проекте не будет проблем с копированием и симлинками. Для Claude же это «целое приключение»: приходится писать дополнительные скрипты и симлинки, что обычно работает неустойчиво.

Внешние источники это подтверждают и уточняют: .agents/skills — кроссагентный стандарт, а Cursor для совместимости читает ещё и .claude/skills, и .codex/skills. Но в обратную сторону Claude универсальную папку не читает — поэтому утилита npx skills с симлинками как раз и закрывает ту самую боль с ручными обвязками, о которой говорит докладчик.

Источники