> ## 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 には、名前、スラッシュコマンドの slug、説明、そして 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 接続の許可の両方に `skills:write` 権限が必要です。サーバーに接続した後で権限を追加した場合は、Flowglad MCP に再接続して `skills:write` を承認し、書き込みツールを利用可能にしてください。

**権限:** 管理者にはデフォルトで 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 には小文字の英字、数字、ハイフンを使用し、英字または数字で始める必要があります。ユーザーが `/` の後に入力するのがこの 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/jp/mcp-server.md)
- [Automations](/docs/jp/automations.md)
- [ようこそ](/docs/jp/agents/introduction.md)


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