スキルインストーラー は何をしますか？
スキルのインストールを支援します。デフォルトでは 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 <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値を指定すると、1回の実行で複数のスキルをインストールします。各スキルは、--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から取得されます。