Skill Installer
스킬 설치를 도와줍니다. 기본적으로 https://github.com/openai/skills/tree/main/skills/.curated 에서 가져오지만, 사용자가 다른 위치를 제공할 수도 있습니다.
작업에 따라 도우미 스크립트를 사용하세요:
- 사용자가 무엇을 사용할 수 있는지 물어보거나, 이 스킬을 사용할 때 수행할 작업을 지정하지 않은 경우 선별된 스킬을 나열합니다.
- 사용자가 스킬 이름을 제공하면 선별된 목록에서 설치합니다.
- 사용자가 GitHub 저장소/경로(비공개 포함)를 제공하면 해당 저장소에서 설치합니다.
도우미 스크립트를 사용하여 스킬을 설치하세요.
의사소통
선별된 스킬을 나열할 때, 사용자 요청의 맥락에 따라 다음과 비슷하게 출력합니다:
{repo}의 스킬:
1. skill-1
2. skill-2 (이미 설치됨)
3. ...
어떤 것을 설치하시겠습니까?
스킬을 설치한 후 사용자에게 다음을 알리세요: "새로운 스킬을 적용하려면 Codex를 다시 시작하세요."
스크립트
이 스크립트들은 모두 네트워크를 사용하므로, 샌드박스에서 실행할 때는 에스컬레이션을 요청하세요.
scripts/list-curated-skills.py(설치 주석과 함께 선별된 목록 출력)scripts/list-curated-skills.py --format jsonscripts/install-skill-from-github.py --repo <소유자>/<저장소> --path <스킬_경로> [<스킬_경로> ...]scripts/install-skill-from-github.py --url https://github.com/<소유자>/<저장소>/tree/<참조>/<경로>
동작 및 옵션
- 공개 GitHub 저장소의 경우 기본적으로 직접 다운로드를 사용합니다.
- 다운로드가 인증/권한 오류로 실패하면 git sparse checkout으로 대체됩니다.
- 대상 스킬 디렉터리가 이미 존재하면 중단합니다.
$CODEX_HOME/skills/<스킬-이름>에 설치됩니다 (기본값은~/.codex/skills).- 여러
--path값으로 한 번에 여러 스킬을 설치할 수 있으며,--name이 제공되지 않으면 각각 경로의 기본 이름에서 이름을 가져옵니다. - 옵션:
--ref <참조>(기본값main),--dest <경로>,--method auto|download|git.
참고사항
- 선별된 목록은 GitHub API를 통해
https://github.com/openai/skills/tree/main/skills/.curated에서 가져옵니다. 사용할 수 없으면 오류를 설명하고 종료합니다. - 비공개 GitHub 저장소는 기존 git 자격 증명 또는 다운로드를 위한 선택적
GITHUB_TOKEN/GH_TOKEN을 통해 액세스할 수 있습니다. - Git 대체는 HTTPS를 먼저 시도한 후 SSH를 시도합니다.
- https://github.com/openai/skills/tree/main/skills/.system 의 스킬은 사전 설치되어 있으므로 사용자가 설치하도록 도울 필요가 없습니다. 사용자가 물어보면 이 점을 설명하기만 하면 됩니다. 사용자가 계속 요청하면 다운로드하여 덮어쓸 수 있습니다.
- 설치 주석은
$CODEX_HOME/skills에서 가져옵니다.