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

# Skills

> ドメイン固有の知識、カスタムワークフロー、組織固有の手順でAIエージェントを拡張する

Skills（スキル）は、汎用エージェントをあなたの環境の専門家に変える指示パッケージです。コーディング規約、レビューチェックリスト、インシデント対応手順など、チームのコンテキストを一度記述するだけで、エージェントは割り当てられたすべてのタスクで自動的にそれを適用します。

エージェントは一般的なベストプラクティスは知っていますが、あなたのチームの慣習は知りません。Skillsはそのギャップを埋めます。毎回のプロンプトで同じルールを繰り返す代わりに、一度エンコードするだけで、ベテランエンジニアの知見がワークスペース全体で共有される標準になります。

## 仕組み

1. **作成** — `SKILL.md` ファイルを手動で作成するか、必要な内容を自然言語で説明してAIに生成させます。
2. **有効化** — ワークスペースでスキルのトグルをオンにします。無効化されたスキルは保存されますが、読み込まれません。
3. **割り当て** — スキルを適用する機能（Code Review、Incident、Assessment、またはその組み合わせ）にスコープを設定します。
4. **適用** — エージェントが割り当てられた機能でタスクを実行すると、スキルを読み込み、デフォルトの動作と並行して指示に従います。

<Frame>
  <img src="https://mintcdn.com/cloudthinker/AeA396afvGSMYSou/images/skills/01-custom-skills-page.png?fit=max&auto=format&n=AeA396afvGSMYSou&q=85&s=d177965127f202fcc12161c16bf16220" alt="有効化トグルと機能割り当てチェックボックスを持つスキルカードを表示するCustom Skills管理ページ" width="2706" height="1528" data-path="images/skills/01-custom-skills-page.png" />
</Frame>

<p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>Skillsページには、すべてのスキルが有効化トグルと機能の割り当てとともに一覧表示されます</p>

## できること

| 機能                  | 説明                                                              | 詳細                                              |
| ------------------- | --------------------------------------------------------------- | ----------------------------------------------- |
| カスタムスキルの作成          | ワークスペース専用スキルを手動で作成するか、自然言語の説明からAIで生成する                          | [Custom skills](/ja/guide/skills/custom-skills) |
| 機能への割り当て            | 各スキルをCode Review、Incident、Assessmentにスコープして、必要な場所でのみ読み込まれるようにする | [Custom skills](/ja/guide/skills/custom-skills) |
| AIで編集               | 会話を通じて既存のスキルを改良する — 例の追加、曖昧さの解消、セクションの再構成                       | [Custom skills](/ja/guide/skills/custom-skills) |
| 効果的なSKILL.mdファイルの作成 | フロントマターフィールド、指示スタイル、エージェントが最も確実に従うパターンを学ぶ                       | [Skill format](/ja/guide/skills/skill-format)   |

## Skillsとナレッジベースの違い

Skillsはエージェントの行動を指示し、[ナレッジベース](/ja/guide/knowledge)はエージェントが参照する情報を提供します。両者は補完的な関係にあります — スキルからエージェントに特定のドキュメントを参照するよう指示できます。

|             | Skills                                 | ナレッジベース                        |
| ----------- | -------------------------------------- | ------------------------------ |
| コンテンツ       | エージェントが従うルールと手順                        | エージェントが参照するドキュメントとウェブサイト       |
| 例           | レビューチェックリスト、命名規則、エスカレーションポリシー          | ランブック、アーキテクチャドキュメント、コンプライアンス文書 |
| エージェントの使用方法 | 割り当てられた機能に対して自動的に読み込まれる                | `#kb` で検索するか、常時利用モードで自動的に参照される |
| フォーマット      | `SKILL.md` ファイル（YAMLフロントマター付きMarkdown） | アップロードされたファイルまたはクロールされたウェブサイト  |
| 最適な用途       | エージェントの動作を変更する                         | 事実とコンテキストを追加する                 |

目安：毎回の実行でエージェントが必ず従うべきものはスキルに書く。関連するときに参照すべきものはナレッジベースに追加する。

## はじめる

<CardGroup cols={2}>
  <Card title="Custom skills" icon="wand-magic-sparkles" href="/ja/guide/skills/custom-skills">
    最初のワークスペーススキルを作成・有効化・割り当てる
  </Card>

  <Card title="Skill format" icon="file-code" href="/ja/guide/skills/skill-format">
    完全な例でSKILL.mdの構造を学ぶ
  </Card>

  <Card title="ナレッジベース" icon="book" href="/ja/guide/knowledge">
    Skillsと並行してエージェントが参照するドキュメントとウェブサイトを提供する
  </Card>

  <Card title="Code review のセットアップ" icon="code-pull-request" href="/ja/guide/code-review/setup">
    リポジトリを接続して、実際のPRにスキルが適用される様子を確認する
  </Card>
</CardGroup>