skill-installer について
OpenAI の厳選コレクションや GitHub 上の別の場所からスキルを一覧表示・インストールするスキルです。Codex のスキルを管理するユーザー向けに、公開・非公開リポジトリ用のスクリプトを備えています。
主な機能
- 01厳選または実験的スキルの一覧表示
- 02GitHub のパスからスキルをインストール
- 03複数スキルの一括インストール
- 04ref、保存先、方式の指定
活用シーン
- 01選択前に利用可能なスキルを確認
- 02指定した厳選スキルをインストール
- 03別のリポジトリからスキルを導入
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ openai/ skills --skill skill-installerインストール後、Claude Code で/skill-installerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSE.txtagents/openai.yamlassets/skill-installer-small.svgscripts/github_utils.pyinstall-skill-from-github.pylist-skills.py詳細
スキルインストーラー
スキルのインストールを支援します。デフォルトでは https://github.com/openai/skills/tree/main/skills/.curated のスキルを使用しますが、ユーザーが別の場所を指定することもできます。
タスクに応じて、次のヘルパースクリプトを使用してください。
- ユーザーから利用可能なスキルを尋ねられた場合、またはこのスキルを使うよう指定されたものの、何をすればよいかが明示されていない場合は、スキルの一覧を表示します。デフォルトでは
.curatedの一覧を表示しますが、実験的なスキルについて尋ねられた場合は--path skills/.experimentalを渡せます。 - ユーザーがスキル名を指定した場合は、キュレーション済みの一覧からインストールします。
- ユーザーが GitHub のリポジトリ/パス(プライベートリポジトリを含む)を指定した場合は、別のリポジトリからインストールします。
ヘルパースクリプトを使用してスキルをインストールしてください。
コミュニケーション
スキルの一覧を表示するときは、ユーザーの依頼の文脈に応じて、次のような形式で出力します。実験的なスキルについて尋ねられた場合は、.curated ではなく .experimental の一覧を表示し、該当するソースを明記してください。
"""
{repo} のスキル:
- skill-1
- skill-2(インストール済み)
- ... どのスキルをインストールしますか? """
スキルをインストールしたら、次のターンから利用可能になることをユーザーに伝えてください。
スクリプト
これらのスクリプトはすべてネットワークを使用するため、サンドボックス内で実行する場合は、実行時に権限昇格を要求してください。
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 のスパースチェックアウトに切り替えます。
- インストール先のスキルディレクトリがすでに存在する場合は、中止します。
$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の内容に基づきます。
コメント
Markdown 対応