スキルインストーラー
スキルのインストールを支援します。デフォルトでは 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 <owner>/<repo> --path <path/to/skill> [<path/to/skill> ・・・]scripts/install-skill-from-github.py --url https://github.com/<owner>/<repo>/tree/<ref>/<path>
動作とオプション
- パブリック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から取得されます。