For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
メインナビゲーション
Theme
概要 ChatGPT と Codex のユーザー向けドキュメント ユースケース

スキル

スキルを使って、MCP ツールを組み合わせたワークフローを繰り返し実行できるようにする方法を説明します。

スキルは、ChatGPT や Codex が繰り返し行う作業の手順と、その作業に必要なリソースをまとめたフォルダーです。MCP サーバーを利用するプラグインでは、スキルがサーバーの役割を補います。ユーザーの目的に応じて、サーバーが提供するツールをどう組み合わせるかをモデルに示します。

各スキルには SKILL.md ファイルがあり、次の内容を記載します。

  • スキルの名前
  • どのような場合にそのスキルの利用を検討すべきかをモデルに伝える説明
  • ワークフローを完了するための手順
  • 必要に応じて含める参考資料、スクリプト、テンプレートなどのリソース

スキルと MCP サーバーの役割分担

MCP サーバーは最新の情報を提供し、許可された操作を実行します。スキルは、それらのツールを使うワークフローを定義します。具体的には、ツールを呼び出すタイミングと順序、結果が不完全な場合の対処方法、最終的な出力に含める内容を示します。

たとえば、スキルでは次のような作業の手順を定義できます。

  • アカウントの利用履歴を取得し、顧客向けの説明資料にまとめる
  • プロジェクトのデータを確認し、リスクを特定して進捗報告の下書きを作成する
  • 検索ツールと取得ツールを組み合わせ、出典を明示する調査ワークフローを構成する
  • MCP ツールの実行結果に、組織の文章作成基準やレビュー基準を適用する

両者の役割を明確に分けてください。MCP サーバーはデータの提供、認証、認可、操作の実行を担います。スキルは再利用できる手順、例、テンプレートなどのリソースを提供します。同梱した手順とリソースだけでワークフローを完了できる場合は、MCP サーバーがなくてもスキルを利用できます。

スキルの読み込み条件

モデルはまず、名前や説明を含むスキルのメタデータを確認します。ユーザーのリクエストがスキルに合致した場合や、ユーザーがスキルを直接呼び出した場合に、手順の全文を読み込みます。

スキルの説明には、ユーザーが達成したい目的と、ワークフローを開始する条件を記載してください。詳しい手順と出力の要件は、手順を記述する本文にまとめてください。

プラグイン内のスキル

スキルはプラグインのワークフローを担います。スキルでは次のことができます。

  • プラグインの MCP サーバーが公開するツールの使い方をモデルに示す
  • 組織固有の手順を、再利用できるテンプレートや参考資料とともにパッケージ化する
  • 最新のデータも権限管理を伴う操作も必要としない場合に、スキル単独でワークフローを実行する

スキルと MCP ツールには、互いを補い合う明確な役割を持たせてください。スキルはワークフローを完了するための手順を示し、MCP サーバーは最新の情報を提供するとともに、許可された操作だけを実行できるようにします。

スキルの作成、テスト、パッケージ化の手順は、次の「スキルの作成」を参照してください。