> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> 外部エージェントと Automation のための再利用可能なパッケージを作成する

Skill は、指示と任意の補助ファイルをまとめた再利用可能なパッケージです。タスクを完了するための再現可能な方法をチームで一度定義すれば、Flowglad 全体で一貫して適用できます。

各 Skill には、名前、スラッシュコマンドのスラッグ、説明、Markdown で記述された指示があります。補助ファイルでは、指示に従うために必要な追加のコンテキストやリソースを提供できます。

## 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` は、受理されたリクエストの検証と昇格の結果を報告します。

Skill を作成または更新するには、チームメイトの組織メンバーシップと MCP 接続の付与の両方に `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` に記述します。

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### Claude

`mkdir -p ~/.claude/skills` で Claude の保存先ディレクトリを作成します。

すべてのプロジェクトに適用するには次のブロックを `~/.claude/CLAUDE.md` に、リポジトリのチームと共有するにはそのリポジトリの `CLAUDE.md` に記述します。

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

ChatGPT / Codex または Claude に、適切なブロックを自身のユーザーレベルの指示ファイルへ追加するよう依頼することもできます。そのファイルは今後のセッションに影響するため、提案された編集を確認してから受け入れてください。この指示はベストエフォートのエージェントのブートストラップです。環境で Skill を確実に更新する必要がある場合は、信頼できる `SessionStart` フックまたは MCP クライアントの統合で同じ同期処理を実装してください。

## Skill が使われる場所

現在、Skill の利用元は 2 つあります:

* 互換性のある外部エージェントは、Flowglad MCP を通じて有効なパッケージを検出・同期し、自動的にマッチさせるか名前で呼び出します。
* Automation は、公開された Skill の特定のリビジョンを OWS の `skill-revision` コードリソースとして固定します。Automation はパッケージのパスとエントリポイントを選択し、エージェントのステップは封印された実行ケイパビリティセットで承認された Skill のみを受け取ります。

1 つ目のパスは、外部エージェントに再利用可能な指示を提供します。2 つ目のパスは、再現可能な Automation の実行に不変のコードと補助ファイルを提供します。公開された Skill は組織全体で共有されるため、承認された Automation はどの Space でも同じ Skill リビジョンを選択できます。利用する Automation とその実行は引き続きそれぞれの Space に属し、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 ライフサイクルを明示的に使用してください。

## Skill テンプレートから始める

**Skills** ページには **Skill Templates** があります。カタログを検索またはフィルタリングし、テンプレートをプレビューして **Copy Skill** を選択します。コピーは組織の Skill となり、他の Skill と同様に編集して公開できます。

## Skill と Automation

Skill は、再利用可能な作業をどのように実行するかを定義します。その作業をいつ実行するかは決定しません。

作業を手動、スケジュール、またはイベントへの応答で実行する必要がある場合は、Automation を使用します。Automation は 1 つ以上の Skill リビジョンを固定できるため、実行ごとに同じ実装が再利用されます。


## Related topics

- [MCP](/docs/ja-jp/mcp-server.md)
- [Automations](/docs/ja-jp/automations.md)
- [ようこそ](/docs/ja-jp/agents/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.