Что решить до установки
Выберите источник, зафиксируйте версию и решите, нужен навык одному пользователю или только конкретному проекту.
Установка начинается не с команды, а с области действия. Личный навык доступен в разных проектах пользователя; проектный хранится рядом с кодом и может разделяться командой. Для незнакомого пакета безопаснее начать с проектной области и тестового репозитория: так проще увидеть изменения и не расширять доверенную область без необходимости.
До подключения пройдите чек-лист проверки AI-навыка.
Как подключить навык в Codex
В Codex используйте встроенный установщик навыков: передайте ему название доступного пакета или точную ссылку на каталог навыка в GitHub. Установщик помещает пакет в каталог навыков Codex и не должен перезаписывать уже существующий навык с тем же именем без отдельного решения пользователя.
- Укажите точный источник
Передайте ссылку на каталог, где находится SKILL.md, а для воспроизводимой установки зафиксируйте ветку, тег или commit источника.
- Проверьте назначение
Сверьте имя и описание установленного навыка с выбранным пакетом; не устанавливайте весь репозиторий, если нужен один каталог.
- Начните новую сессию или ход
Codex обнаруживает установленные навыки при обновлении контекста. После установки откройте новую задачу или продолжите следующим сообщением согласно подсказке установщика.
Как подключить навык в Claude Code
Официальная документация Claude Code описывает два файловых уровня: личный каталог ~/.claude/skills/ и проектный .claude/skills/. Внутри нужен отдельный каталог навыка с файлом SKILL.md. После размещения Claude Code обнаруживает навык автоматически, когда его описание соответствует задаче.
| Область | Когда выбирать |
|---|---|
| ~/.claude/skills/<имя>/SKILL.md | Навык нужен одному пользователю в разных проектах |
| .claude/skills/<имя>/SKILL.md | Навык относится к конкретному репозиторию и проверяется вместе с ним |
Некоторые поставщики распространяют навыки как плагины или через собственную команду установки. Используйте такой способ только если он описан в официальном репозитории пакета; универсальной командой для любого источника он не является.
Что проверить в пакете
- В корне каталога навыка есть читаемый SKILL.md с названием и назначением.
- Ссылки из инструкции ведут на существующие локальные файлы.
- Скрипты и зависимости соответствуют заявленной задаче.
- Нет скрытой отправки данных, запроса лишних секретов или отключения подтверждений.
- Источник и версия записаны так, чтобы проверку можно было повторить.
Как провести первый запуск
- Возьмите безопасную задачу
Используйте тестовый проект и данные без секретов; задача должна давать наблюдаемый результат без публикации и production-доступа.
- Назовите навык явно
Попросите агента применить установленный навык и кратко сообщить, какой файл инструкции был загружен.
- Ограничьте инструменты
Оставьте только необходимые чтение и запись в тестовой области; сеть, оболочку и внешние сервисы подключайте отдельно.
- Проверьте изменения
Сравните фактические действия с инструкцией, изучите diff и убедитесь, что агент остановился перед внешними или необратимыми шагами.
Если навык не обнаружился
- Проверьте точное расположение каталога и имя файла SKILL.md.
- Убедитесь, что описание навыка действительно соответствует формулировке задачи.
- Начните новую сессию после установки или обновления пакета.
- Проверьте, не существует ли другой навык с тем же именем.
- Для проектного навыка убедитесь, что Codex или Claude Code открыт в нужном репозитории.
Не решайте проблему копированием одного и того же пакета во все доступные каталоги. Сначала определите, какой уровень должен быть источником истины, иначе обновления быстро разойдутся.
Как обновлять и удалять навык
Перед обновлением сравните новую версию с проверенной: изменения в SKILL.md, скриптах и зависимостях могут расширить доступы или изменить условия запуска. После обновления повторите ограниченный тест. Удаляйте только тот каталог, который был выбран при установке, и заранее проверьте, не используется ли проектной командой его версия в репозитории.
Для выбора следующего пакета откройте каталог проверенных навыков: карточки показывают источник, версию, назначение и известные ограничения.
Официальные источники
- Skill installer в CodexПоддерживаемые источники и поведение встроенного установщика Codex.
- Agent Skills в Claude CodeЛичные и проектные каталоги, обнаружение и ограничения навыков.
- Спецификация Agent SkillsСтруктура SKILL.md и переносимый формат пакета.