skill-installer

Skill Installer — официальный системный skill OpenAI для установки Agent Skills в $CODEX_HOME/skills. Его задача узкая: показать доступные навыки, установить выбранный skill из curated-каталога или загрузить skill по указанному GitHub-репозиторию и пути. По умолчанию curated-источник находится в openai/skills, а для экспериментального списка можно передать путь skills/.experimental. При выводе списка источник должен быть явно назван, чтобы curated и experimental варианты не смешивались. Для просмотра каталога используется scripts/list-skills.py; поддерживается обычный текстовый вывод и --format json. Когда навык уже установлен, список отмечает это состояние. Для установки из GitHub предусмотрены scripts/install-skill-from-github.py, параметры --repo <owner>/<repo> --path <path/to/skill> и --url https://github.com/<owner>/<repo>/tree/<ref>/<path>. Несколько значений --path позволяют установить несколько навыков за один запуск; имя по умолчанию берётся из последнего компонента пути, а при необходимости задаётся через --name. Поведение загрузчика можно уточнять без изменения исходного skill-пакета. --ref выбирает ветку или другой ref и по умолчанию равен main; --dest задаёт каталог назначения; --method принимает auto, download или git. В режиме auto сначала используется прямая загрузка, а при проблемах с авторизацией предусмотрен fallback на sparse checkout через git. Это позволяет работать с публичными и private-репозиториями через уже настроенные git-учётные данные или необязательные GITHUB_TOKEN/GH_TOKEN, не превращая токен в аргумент, который нужно сохранять в проекте. Установка не должна молча перезаписывать существующую папку: загрузчик прерывается, если каталог целевого skill уже существует. Для публичных источников используется прямое скачивание, а git fallback пробует HTTPS и затем SSH. После установки пользователю сообщается, что skill станет доступен в следующем turn. Этот результат относится к локальному каталогу $CODEX_HOME/skills, а не к публикации навыка в стороннем продукте или к автоматической активации текущего диалога. В составе OpenAI skills системные навыки уже предустановлены; поэтому для skills/.system не требуется помогать с повторной установкой, если пользователь специально не просит скачать и перезаписать такой skill. Каталог по умолчанию — curated, experimental нужно запрашивать отдельным --path. Skill Installer не обещает, что произвольный GitHub-путь содержит корректный SKILL.md, не проводит security-аудит содержимого и не заменяет проверку доверия к репозиторию. Практическая граница инструмента — выбор источника, загрузка и размещение skill; дальнейшая проверка инструкций и решение о применении остаются за пользователем и агентом.