メインコンテンツへスキップ
Skills(スキル)は、汎用エージェントをあなたの環境の専門家に変える指示パッケージです。コーディング規約、レビューチェックリスト、インシデント対応手順など、チームのコンテキストを一度記述するだけで、エージェントは割り当てられたすべてのタスクで自動的にそれを適用します。 エージェントは一般的なベストプラクティスは知っていますが、あなたのチームの慣習は知りません。Skillsはそのギャップを埋めます。毎回のプロンプトで同じルールを繰り返す代わりに、一度エンコードするだけで、ベテランエンジニアの知見がワークスペース全体で共有される標準になります。

仕組み

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

Skillsページには、すべてのスキルが有効化トグルと機能の割り当てとともに一覧表示されます

できること

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

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

Skillsはエージェントの行動を指示し、ナレッジベースはエージェントが参照する情報を提供します。両者は補完的な関係にあります — スキルからエージェントに特定のドキュメントを参照するよう指示できます。
Skillsナレッジベース
コンテンツエージェントが従うルールと手順エージェントが参照するドキュメントとウェブサイト
レビューチェックリスト、命名規則、エスカレーションポリシーランブック、アーキテクチャドキュメント、コンプライアンス文書
エージェントの使用方法割り当てられた機能に対して自動的に読み込まれる#kb で検索するか、常時利用モードで自動的に参照される
フォーマットSKILL.md ファイル(YAMLフロントマター付きMarkdown)アップロードされたファイルまたはクロールされたウェブサイト
最適な用途エージェントの動作を変更する事実とコンテキストを追加する
目安:毎回の実行でエージェントが必ず従うべきものはスキルに書く。関連するときに参照すべきものはナレッジベースに追加する。

はじめる

Custom skills

最初のワークスペーススキルを作成・有効化・割り当てる

Skill format

完全な例でSKILL.mdの構造を学ぶ

ナレッジベース

Skillsと並行してエージェントが参照するドキュメントとウェブサイトを提供する

Code review のセットアップ

リポジトリを接続して、実際のPRにスキルが適用される様子を確認する