skill-installer について
skill-installerは、Codexユーザーがスキルを一覧表示してインストールするためのツールです。OpenAIの厳選リストを標準としつつ、別のGitHubリポジトリやパスにも対応し、複数のパスを一度に処理できます。
主な機能
- 01厳選または実験的スキルの一覧表示
- 02GitHubリポジトリからのインストール
- 03プライベートリポジトリのパスに対応
- 04複数のスキルパスを一括インストール
- 05ダウンロード失敗時のGitへの切り替え
活用シーン
- 01利用可能なスキルと導入状況の確認
- 02名前を指定した厳選スキルの導入
- 03別のGitHubリポジトリからのスキル導入
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ nickcrew/ claude-cortex --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 から取得しますが、ユーザーはほかの場所を指定することもできます。実験的なスキルは https://github.com/openai/skills/tree/main/skills/.experimental にあり、同じ方法でインストールできます。
タスクに応じて、次のヘルパースクリプトを使用します。
- ユーザーが利用可能なスキルを尋ねた場合、または何をするか指定せずにこのスキルを使用した場合は、スキルを一覧表示します。デフォルトの一覧は
.curatedですが、実験的なスキルについて尋ねられた場合は--path skills/.experimentalを指定できます。 - ユーザーがスキル名を指定した場合は、キュレーション済みリストからインストールします。
- ユーザーが GitHub リポジトリ/パス(プライベートリポジトリを含む)を指定した場合は、別のリポジトリからインストールします。
ヘルパースクリプトを使用してスキルをインストールします。
コミュニケーション
スキルを一覧表示する場合は、ユーザーのリクエストの内容に応じて、おおむね次のように出力します。実験的なスキルについて尋ねられた場合は、.curated の代わりに .experimental のスキルを一覧表示し、取得元を明記します。
"""
{repo} のスキル:
- skill-1
- skill-2(インストール済み)
- ... どれをインストールしますか? """
スキルをインストールした後、ユーザーに「新しいスキルを反映するには、Codex を再起動してください。」と伝えます。
スクリプト
これらのスクリプトはすべてネットワークを使用するため、サンドボックス内で実行する場合は、実行時に権限昇格を要求してください。
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 対応