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 저장소/경로(비공개 저장소 포함)를 제공하면 다른 저장소에서 설치합니다.
헬퍼 스크립트로 스킬을 설치하세요.
커뮤니케이션
스킬 목록을 표시할 때는 사용자 요청의 맥락에 따라 다음과 같이 출력합니다. 사용자가 실험적 스킬에 대해 묻는다면 .curated 대신 .experimental에서 목록을 가져오고 소스를 적절히 표시합니다:
""" {repo}의 스킬:
- skill-1
- skill-2 (이미 설치됨)
- ... 설치할 항목을 선택하시겠습니까? """
스킬을 설치한 후에는 다음 턴에 사용할 수 있다고 사용자에게 알립니다.
스크립트
이 모든 스크립트는 네트워크를 사용하므로, 샌드박스에서 실행할 때는 실행 전에 권한 상승을 요청하세요.
scripts/list-skills.py(설치된 주석과 함께 스킬 목록 출력)scripts/list-skills.py --format json- 예시 (실험적 목록):
scripts/list-skills.py --path skills/.experimental scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/to/skill> [<path/to/skill> ...]scripts/install-skill-from-github.py --url https://github.com/<owner>/<repo>/tree/<ref>/<path>- 예시 (실험적 스킬):
scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>
동작 및 옵션
- 공개 GitHub 저장소의 경우 기본적으로 직접 다운로드를 사용합니다.
- 인증/권한 오류로 다운로드가 실패하면 git sparse checkout으로 대체됩니다.
- 대상 스킬 디렉터리가 이미 존재하면 중단됩니다.
$CODEX_HOME/skills/<skill-name>에 설치됩니다 (기본값은~/.codex/skills).- 여러
--path값을 사용하면 한 번에 여러 스킬을 설치하며, 각 스킬 이름은--name이 제공되지 않는 한 경로의 기본 이름에서 가져옵니다. - 옵션:
--ref <ref>(기본값main),--dest <path>,--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에서 가져옵니다.