grahama1970/skill-installer

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リポジトリ/パスを指定した場合は、そのリポジトリからインストールします（プライベートリポジトリも可）。

ヘルパースクリプトでスキルをインストールします。

コミュニケーション

スキル一覧を表示する際は、ユーザーのリクエストの文脈に応じて以下のように出力します。実験的スキルについて尋ねられた場合は .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 から取得されます。