Flowglad をチームの Skill ライブラリとして使う
Flowglad は各 Skill をバージョン管理されたパッケージとして保持します。変更を公開すると、以前のパッケージをその場で置き換えるのではなく、新しいリビジョンが作成されます。組織の管理者は Skill の History を開き、リビジョンの確認、変更の比較、以前のリビジョンの復元、またはドラフトの破棄を（それらの操作が利用可能な場合に）行えます。 これにより、どの時点でどのバージョンが有効だったかを保持しながら、再利用可能な指示を一元的に管理できる場所をチームに提供します。ドラフトや却下されたリビジョンが有効なバージョンを置き換えることはありません。MCP を通じて Skill を管理する
Flowglad MCP サーバーを接続すると、エージェントが組織の Skill ライブラリを調べて管理できるようになります:skills.listは、その接続から参照できる Skill を返します。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 を有効にします。これにより、チームメイトを管理者にすることなく、組織の Skill を作成および更新する権限が付与されます。
Flowglad MCP の Skill をエージェントに読み込む
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 クライアントの統合で同じ同期処理を実装してください。
Skill が使われる場所
現在、Skill の利用元は 2 つあります:- 互換性のある外部エージェントは、Flowglad MCP を通じて有効なパッケージを検出・同期し、自動的にマッチさせるか名前で呼び出します。
- Automation は、公開された Skill の特定のリビジョンを OWS の
skill-revisionコードリソースとして固定します。Automation はパッケージのパスとエントリポイントを選択し、エージェントのステップは封印された実行ケイパビリティセットで承認された Skill のみを受け取ります。
Skill の作成とメンテナンス
組織メニュー → Skills → New Skill を開きます。Skill タブで、Name、Slug、任意の Description、および再利用可能な指示を Markdown に入力します。補助的なパッケージファイルには Files タブを使用し、Create Skill を選択します。 Slug には小文字、数字、ハイフンを使用し、先頭は文字または数字である必要があります。ユーザーが/ の後に入力するのがこの 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 ライフサイクルを明示的に使用してください。