스킬 설치 도구은(는) 무엇을 하나요?
스킬 설치를 도와줍니다. 기본적으로 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}의 스킬 목록:
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 <경로/스킬> [<경로/스킬> ...]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 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에서 가져옵니다. API를 사용할 수 없으면 오류를 설명하고 종료합니다. - 비공개 GitHub 저장소는 기존 Git 자격 증명 또는 다운로드를 위한 선택적
GITHUB_TOKEN/GH_TOKEN을 통해 접근할 수 있습니다. - Git 대체 방식은 HTTPS를 먼저 시도한 후 SSH를 시도합니다.
- https://github.com/openai/skills/tree/main/skills/.system 의 스킬은 사전 설치되어 있으므로 사용자가 설치하도록 도울 필요가 없습니다. 사용자가 문의하면 이 점을 설명하세요. 사용자가 강력히 요청하면 다운로드하여 덮어쓸 수 있습니다.
- 설치 상태 표시는
$CODEX_HOME/skills에서 가져옵니다.