skill-installer

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 json
• 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>

動作とオプション

• パブリックな GitHub リポジトリに対しては、デフォルトで直接ダウンロードを行います。
• 認証/権限エラーでダウンロードが失敗した場合は、git のスパースチェックアウトにフォールバックします。
• インストール先のスキルディレクトリが既に存在する場合は中止します。
• $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 から取得されます。