mcpField
S
skill-installer

skill-installer

github.com/openaiエージェントワークフロー28.4k3.7k 回インストール18 週間前に更新
リポジトリ

skill-installer について

OpenAI の厳選コレクションや GitHub 上の別の場所からスキルを一覧表示・インストールするスキルです。Codex のスキルを管理するユーザー向けに、公開・非公開リポジトリ用のスクリプトを備えています。

主な機能

  1. 01厳選または実験的スキルの一覧表示
  2. 02GitHub のパスからスキルをインストール
  3. 03複数スキルの一括インストール
  4. 04ref、保存先、方式の指定

活用シーン

  1. 01選択前に利用可能なスキルを確認
  2. 02指定した厳選スキルをインストール
  3. 03別のリポジトリからスキルを導入

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openai/skills --skill skill-installer

インストール後、Claude Code で/skill-installerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE.txt
agents/
openai.yaml
assets/
skill-installer-small.svg
scripts/
github_utils.py
install-skill-from-github.py
list-skills.py

詳細

スキルインストーラー

スキルのインストールを支援します。デフォルトでは https://github.com/openai/skills/tree/main/skills/.curated のスキルを使用しますが、ユーザーが別の場所を指定することもできます。

タスクに応じて、次のヘルパースクリプトを使用してください。

  • ユーザーから利用可能なスキルを尋ねられた場合、またはこのスキルを使うよう指定されたものの、何をすればよいかが明示されていない場合は、スキルの一覧を表示します。デフォルトでは .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 のスパースチェックアウトに切り替えます。
  • インストール先のスキルディレクトリがすでに存在する場合は、中止します。
  • $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 の内容に基づきます。

コメント