---
title: スキルを書いて共有する
order: 5
description: カスタムスキルをワークスペースにアップロードし、チーム全体に広げる。
---

# スキルを書いて共有する

Investibook は独自のスキルで拡張できます —— あなたのチーム固有の問題クラスに対する
調査方法をエージェントに教えるための能力バンドルです。

## 1. スキルを書く

スキルは次を含むディレクトリです：

- そのスキルを **いつ** 使うべきかをエージェント向けに記述した `SKILL.md`。
- ステップごとの手順と参考資料。
- 任意の補助スクリプトやプロンプト。

良いスキル記述は **トリガーフレーズ**、**必要なソース**（例：「TiDB Cloud Dedicated
クラスタの cluster meta」）、および **使うべきでない例** を明確にします。

## 2. ワークスペースにアップロード

**Settings → Skill Hub** を開き、**Upload** をクリックします。

![Upload ボタンと既存スキルが並ぶ Skill Hub](/docs/_assets/skill-hub-settings.png)

Investibook がスキル構造を検証し、現在のワークスペースに追加します。それ以降、エージェントは
ビルトインスキルと同様にそれを選び、sources パネルにも表示されます。

> **スコープはワークスペースのみ。** アップロードは他のワークスペースやチームメイトに
> 影響しません。高速イテレーション用：調整してアップロードし、再度エージェントに尋ねる。

## 3. チームに共有する

スキルが安定したら、
[tidbcloud/nutshell-skills](https://github.com/tidbcloud/nutshell-skills) に
プルリクエストを送ります。マージされるとビルトインスキルとして全てのワークスペースで
利用可能になります。

## 4. 利用状況を見る

ビルトインカタログに入った後は、[Ranking](/docs/features/skill-ranking) ページで
何人のエンジニアがどれくらいの頻度で使っているかを確認できます。