Flowglad をチームの Skill ライブラリとして使用する
Flowglad は各 Skill をバージョン管理されたパッケージとして保持します。変更を公開すると、以前のパッケージをその場で置き換えるのではなく、新しいリビジョンが作成されます。組織の管理者は Skill の History を開いて、リビジョンの確認、変更の比較、以前のリビジョンの復元、またはドラフトの破棄を(それらの操作が利用可能な場合に)行えます。 これにより、チームは再利用可能な手順を管理された 1 つの場所で維持しつつ、特定の時点でどのバージョンがアクティブだったかを保持できます。ドラフトや却下されたリビジョンは、アクティブなバージョンを置き換えません。MCP を通じて Skills を管理する
Flowglad MCP サーバーに接続すると、エージェントが組織の Skill ライブラリを確認・管理できるようになります:skills.listは、接続から参照できる Skills を返します。skills.getは、1 つの Skill の最新およびアクティブなリビジョンのメタデータを返します。skills.createは、新しい Skill パッケージを送信します。skills.create_candidateは、既存の Skill の新しいリビジョンを送信します。skills.publish_revisionは、保留されたリビジョンを検証して公開します。skills.create_package_upload_sessionとskills.finalize_package_upload_sessionは、インラインで送信するには大きすぎるパッケージを転送します。skills.getは、受理されたリクエストの検証と昇格の結果を報告します。
skills:write 権限が必要です。サーバーに接続した後に権限を追加した場合は、Flowglad MCP に再接続して skills:write を承認し、書き込みツールを利用可能にしてください。
権限: Admin にはデフォルトで Skill の作成権限があります。Contributor に同じ権限を付与するには、Settings → Team を開き、チームメイトを選択して Skill Authoring を有効にします。これにより、チームメイトを管理者にすることなく、組織の Skills を作成・更新する権限が付与されます。
Flowglad MCP の Skills をエージェントに読み込む
Flowglad MCP サーバーは、MCP の初期化時にio.modelcontextprotocol/skills を通知します。これにより、互換性のあるクライアントに対して、サーバーがエージェント Skill のメソッド skills/list と skills/get を実装していることが伝わります。返される各 Skill には skill:// リソース URI とコンテンツダイジェストが含まれ、クライアントは resources/read でファイルを取得できます。
サーバーに接続しても、クライアントが skills/list を呼び出したり、返されたパッケージをインストールしたりすることは保証されません。クライアントのサポート状況はさまざまです。各セッションの開始時にエージェントに Flowglad レジストリを更新させたい場合は、ChatGPT / Codex または Claude に起動時の指示を追加してください。
MCP の命名: 名前は意図的に異なっています。ドット付きの skills.list は、組織のバージョン管理された Skill レコードのための Flowglad ツールです。スラッシュ付きの skills/list は、エージェント向けの Skill パッケージを検出するための MCP プロトコル拡張メソッドです。
起動時の指示を追加する
新しいセッションを開始する前に一度だけ保存先ディレクトリを作成し、その後、対応する以下の指示ブロックを追加します。ChatGPT / Codex
mkdir -p ~/.agents/skills で ChatGPT / Codex の保存先ディレクトリを作成します。
すべてのプロジェクトに適用するには以下のブロックを ~/.codex/AGENTS.md に、リポジトリのチームと共有するにはそのリポジトリの AGENTS.md に記述します。
AGENTS.md
Claude
mkdir -p ~/.claude/skills で Claude の保存先ディレクトリを作成します。
すべてのプロジェクトに適用するには以下のブロックを ~/.claude/CLAUDE.md に、リポジトリのチームと共有するにはそのリポジトリの CLAUDE.md に記述します。
CLAUDE.md
SessionStart フックまたは MCP クライアントの統合で同じ同期処理を実装してください。
Skills が使用される場所
Skills には現在 2 つの利用者があります:- 互換性のある外部エージェントは、Flowglad MCP を通じて有効なパッケージを検出・同期し、それらを自動的にマッチさせるか、名前で呼び出します。
- Automations は、公開済みの特定の Skill リビジョンを OWS の
skill-revisionコードリソースとして固定します。Automation はパッケージのパスとエントリーポイントを選択し、エージェントのステップには、封印された実行ケイパビリティセットで承認された Skills のみが渡されます。
Skills の作成と管理
組織メニュー → Skills → New Skill を開きます。Skill タブで、Name、Slug、任意の Description、および再利用可能な手順を Markdown で入力します。補助的なパッケージファイルには Files タブを使用し、Create Skill を選択します。 Slug には小文字の英字、数字、ハイフンを使用し、英字または数字で始める必要があります。ユーザーが/ の後に入力する文字列になります。
Skill を作成または編集すると、ドラフトが作成されます。Skill の詳細ページでは編集内容が自動保存されます。Publish Draft を選択すると、ドラフトが検証されて公開されます。検証に失敗した場合は、表示される診断情報を使ってドラフトを修正し、再度公開してください。
History を使用すると、リビジョンの確認、置き換えられたリビジョンの復元、または変更可能なドラフトの破棄を(それらの操作が利用可能な場合に)行えます。Disable Skill は、リビジョン履歴を削除せずに、外部エージェントの検出と Automation の解決から Skill を除外します。Enable Skill を選択すると、再び利用可能になります。
MCP で Skill を作成または編集する
パッケージ中心の作成には、接続済みの外部 MCP クライアントを使用します。既存の Skill を編集する前にskills.get を呼び出してください。新しいパッケージには skills.create を、現在アクティブなリビジョンに基づくリビジョンには skills.create_candidate を使用します。
小さなパッケージはインラインで渡せます。大きなパッケージの場合は、skills.create_package_upload_session を呼び出し、要求されたオブジェクトをアップロードして、skills.finalize_package_upload_session で完了します。検証が保留された場合は、skills.publish_revision を呼び出します。受理されたライフサイクルリクエストとその検証または昇格の結果は、skills.get をポーリングして確認します。
Skill を公開しても、Automation の作成、改訂、有効化は行われません。必要な場合は、Automation の MCP ライフサイクルを明示的に使用してください。