> ## 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.
# Custom Skills
> チームの知識をエンコードしてエージェントがすべてのタスクで適用できるワークスペーススキルを作成・有効化・割り当てる
Custom Skills（カスタムスキル）は、チームの知識をエンコードするワークスペース専用の指示パッケージです。レビューチェックリスト、ランブック、命名規則、コンプライアンスルールなどをエンコードすることで、エージェントがすべてのタスクで一貫して適用できます。コンテキストを一度記述するだけで、エージェントはスキルが割り当てられた場所で自動的に読み込みます。
## スキルがエンコードするもの
エージェントは一般的なベストプラクティスは知っていますが、あなたのコードベース、ランブック、レビュー基準での「良い状態」は知りません。スキルはそのコンテキストを外部化し、毎回の会話で入力し直す必要をなくし、ベテランエンジニアの知見を一人のエンジニアが持つ暗黙知から、チーム全体のアーティファクトにします。
| ドメイン | 例 |
| ----------- | -------------------------------------------------- |
| コードレビュー | 命名規則、API設計ルール、セキュリティレビューチェックリスト、パフォーマンスホットスポットパターン |
| インシデント対応 | エスカレーションポリシー、ランブック選択ルール、サービス固有のデバッグ順序 |
| クラウドオペレーション | アカウントタグ規則、環境プロモーションルール、コスト帰属ポリシー、コンプライアンス制約 |
| ドキュメント | スタイルガイド、用語集、文体ルール |
同じ指示を2回以上プロンプトに入力していると気づいたら、その指示はスキルに書くべきです。
## 前提条件
* CloudThinkerワークスペース
* スキルを手動で作成する場合は [SKILL.mdフォーマット](/ja/guide/skills/skill-format) の理解
## スキルを作成する
サイドバーから **Skills** に移動します。このページにはワークスペース内のすべてのスキルが有効化トグルと機能の割り当てとともに一覧表示されます。
ドロップダウンから作成方法を選択します。
必要な内容を自然言語で説明して、スキル作成エージェントに下書きを作成させます。
1. **Create with AI** をクリックしてチャットセッションを開きます。
2. チームが適用する具体的なルールを一つ説明します — 命名規則、レビューチェックリスト項目、廃止警告など。
3. エージェントがフロントマターと構造化された指示を持つSKILL.mdを生成します。
4. 下書きを確認して **Save** をクリックします。
これが最初のスキルへの最速ルートです。後でAI編集で改良できます。
フォームを使用してスキルを手動で作成します。
1. **Write skill instructions** をクリックします。
2. 各フィールドを入力します: **Name**（`api-review-standards` のようなスラグ形式の識別子）、**Description**（短い概要）、**Instructions**（Markdownで書いたスキルの全内容）。
3. **Save** をクリックします。
SKILL.mdの構造と完全な例については [Skill format](/ja/guide/skills/skill-format) を参照してください。
**成功状態:** 新しいスキルがSkillsページにカードとして表示されます。
## スキルを有効化して割り当てる
スキルはオンにして少なくとも一つの機能にスコープを設定するまで何もしません。
スキルカードのスイッチを使用します。無効化されたスキルは保存されますが、読み込まれません — ライブのエージェント動作に影響を与えずに変更を下書きするときに便利です。
スキルが適用される機能にチェックを入れます。スキルは複数の機能に同時に属せます:
* **Code Review** — PRの分析中に適用
* **Incident** — インシデント調査と根本原因分析中に適用
* **Assessment** — インフラ評価中に適用
スキルはそれが関係する場所にのみ割り当ててください。コードレビューの命名規則はインシデントトリアージ中に読み込む必要はありません。
割り当てられた機能でタスクをトリガーします — スキルがCode Reviewをカバーしている場合はプルリクエストを開きます。エージェントは[エージェントループ](/ja/index)のAnalyzeフェーズで割り当てられたスキルを参照するため、エージェントの推論とコメントにルールが現れるはずです。
**成功状態:** エージェントの出力が、あなたがルールを再度述べなくてもそのルールを引用または適用しています。そうでない場合は、指示が抽象的すぎる可能性があります — 具体的な例で書き直してテストし直してください。
## スキルを管理する
### 詳細を表示
スキルカードをクリックして詳細ビューを開きます: 左にファイルツリー、右にレンダリングされたMarkdown。指示を最初から最後まで読んでください — あなたにとって曖昧なルールはエージェントにとっても曖昧です。
### AIで編集
詳細ビューから **Edit with AI** をクリックして、会話を通じてスキルを改良します — 例の追加、曖昧さの解消、セクションの再構成。エージェントは変更を加える前に既存のコンテンツを読み込みます。
### 削除
詳細ビューからスキルを永久に削除します。
スキルの削除は取り消しできません。再度必要になる可能性がある場合は、削除ではなく無効化してください。
## 効果的なスキルの書き方
* **具体的に書く。** 例を伴う具体的なルールは曖昧なガイドラインより優れています — 「命名スタイルに従う」より「複数単語のパスにはkebab-caseを使用する」の方が効果的です。
* **スキルは1ドメインに絞る。** セキュリティルールとパフォーマンスガイドラインは別々にして、独立して割り当てられるようにします。
* **例から始める。** エージェントは抽象的な説明より実証されたパターンをより確実に따います。
* **まず一つの機能でテストする。** 新しいスキルを一つの機能で有効化し、実際の実行を数回確認してから、より広く割り当てます。
* **反復する。** レビュー結果やチームのフィードバックに基づいてスキルを磨くために **Edit with AI** を使用します。
## 次のステップ
SKILL.mdファイルの構造、フロントマターリファレンス、効果的な指示を書くためのベストプラクティスを学ぶ。
CloudThinkerプラットフォームとエージェントワークフローにおけるSkillsの位置付けを理解する。