skill-installer

Установщик навыков

Помогает устанавливать навыки. По умолчанию они берутся с сайта https://github.com/openai/skills/tree/main/skills/.curated, но пользователи также могут указать другие источники. Экспериментальные навыки находятся на сайте https://github.com/openai/skills/tree/main/skills/.experimental и могут быть установлены таким же образом.

Используйте вспомогательные скрипты в зависимости от задачи:

• Выводите список навыков, когда пользователь спрашивает, что доступно, или если пользователь запускает этот навык, не указав, что нужно сделать. По умолчанию отображается список из каталога .curated, но вы можете передать параметр --path skills/.experimental, когда пользователь спрашивает об экспериментальных навыках.
• Устанавливайте из отборного списка, когда пользователь указывает название навыка.
• Устанавливайте из другого репозитория, когда пользователь указывает репозиторий/путь на GitHub (включая частные репозитории).

Устанавливайте навыки с помощью вспомогательных скриптов.

Взаимодействие

При выводе списка навыков выводите примерно следующее, в зависимости от контекста запроса пользователя. Если пользователь спрашивает об экспериментальных навыках, выводите список из .experimental вместо .curated и соответствующим образом обозначьте источник: """ Навыки из {repo}:

1. skill-1
2. skill-2 (уже установлен)
3. ... Какие из них вы хотите установить? """

После установки навыка сообщите пользователю, что он будет доступен в его следующем ходу.

Скрипты

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

• scripts/list-skills.py (выводит список навыков с аннотациями об установленных навыках)
• scripts/list-skills.py --format json
• Пример (список экспериментальных навыков): scripts/list-skills.py --path skills/.experimental
• scripts/install-skill-from-github.py --repo / --path <path/to/skill> [<path/to/skill> ...]
• scripts/install-skill-from-github.py --url https://github.com///tree//
• Пример (экспериментальный навык): scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/

Поведение и параметры

• По умолчанию используется прямая загрузка из общедоступных репозиториев GitHub.
• Если загрузка завершилась сбоем из-за ошибок авторизации или прав доступа, используется резервный вариант — частичная проверка репозитория с помощью git.
• Процесс прерывается, если целевой каталог навыка уже существует.
• Устанавливает в $CODEX_HOME/skills/ (по умолчанию ~/.codex/skills).
• Указание нескольких значений параметра --path позволяет установить несколько навыков за один запуск; каждый из них получит имя, образованное на основе базового имени пути, если не указан параметр --name.
• Опции: --ref (по умолчанию main), --dest , --method auto|download|git.

Примечания

• Подборка навыков извлекается с https://github.com/openai/skills/tree/main/skills/.curated через API GitHub. Если доступ отсутствует, выдается сообщение об ошибке и программа завершается.
• Доступ к частным репозиториям GitHub для загрузки можно получить с помощью существующих учетных данных git или опциональныхGITHUB_TOKEN/GH_TOKEN.
• При использовании Git сначала пробуется HTTPS, затем SSH.
• Навыки, расположенные по адресу https://github.com/openai/skills/tree/main/skills/.system, уже предустановлены, поэтому нет необходимости помогать пользователям в их установке. Если они спросят, просто объясните это. Если они настаивают, вы можете скачать и перезаписать.
• Установленные аннотации берутся из $CODEX_HOME/skills.