> ## 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

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

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

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

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

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

## Skills が使用される場所

Skills には現在 2 つの利用者があります:

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

1 つ目の経路は、外部エージェントに再利用可能な手順を提供します。2 つ目の経路は、再現可能な Automation の実行に不変のコードと補助ファイルを提供します。公開済みの Skills は組織全体で共有されるため、承認された Automation はどの Space でも同じ Skill リビジョンを選択できます。利用する側の Automation とその実行は引き続きそれぞれの Space が所有し、Skill を選択してもその境界は変わりません。

## 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 ライフサイクルを明示的に使用してください。

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

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

## Skills と Automations

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

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


## Related topics

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


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