メインコンテンツへスキップ

スキルとは何ですか?

スキルは、リポジトリにコミットするか、Customize ページで作成する SKILL.md ファイルで、Devin に再利用可能な手順——つまり、Devin に一貫して従わせたい、繰り返し可能なあらゆるワークフロー——を教えるものです。PR を作成する前のアプリのテスト、環境へのデプロイ、コードベースの調査、新しいサービスのひな形作成など、ステップごとの手順として書けるものであれば、スキルにできます。 オープンな Agent Skills standard に準拠しているため、同じスキルファイルを複数の AI コーディングツール間で共通して利用できます。 リポジトリ内の .agents/skills/<skill-name>/SKILL.md にスキルファイルを配置してください。Devin は、接続されているすべてのリポジトリからそれらを自動的に検出します。完全なファイル形式のリファレンスについては、Agent Skills specification を参照してください。
スキルは必ずしもリポジトリ内に置く必要はありません。プラグインに含まれるスキルは、個人、組織、または Enterprise のスコープでインストールできます。インストールしたスキルは、そのスコープ内のすべてのセッションでリポジトリのスキルとともに利用できます。

スキルが重要な理由

スキルがないと、Devin は毎回のセッションごとにワークフローをゼロから把握しなければなりません。スキルがあれば、手順を一度定義するだけで、Devin は毎回確実にその手順に従います。スキルは、次のようなワークフローで特に役立ちます。
  • 毎回同じやり方で実行する必要がある — テストのチェックリスト、デプロイ手順、レビュー手順
  • リポジトリ固有の知識が必要である — 起動するサービス、使用するポート、実行するコマンド
  • 動的なコンテキストを活用すると効果的である — 呼び出し時に git diff、ブランチ名、環境情報を取り込む

Devin はスキルを自動提案します

Devin はスキルを自動で提案します。Devin がアプリケーションをテストしたり、セッション中にセットアップについて新しいことを学習したりすると、その知識を取り込むためのスキルを作成または更新することを提案します。セッションのタイムラインには、次の内容を含む提案が表示されます:
  • 学習内容の要約 (例: 「Docker でバックエンドを起動する方法」)
  • 提案された SKILL.md ファイルの内容
  • スキルをリポジトリにコミットするための “Create PR” ボタン
時間の経過とともに、Devin はリポジトリ内に、アプリケーションの実行方法、テスト方法、デプロイ方法に関するスキルのライブラリを蓄積していきます。スキルには動的ワークフロースクリプトを含めることもできるため、一度実行したマルチエージェントのオーケストレーションを再利用可能にできます。

例

PR を作成する前のテスト

PR を作成する前に Next.js アプリを検証する方法を Devin に指示するスキル:

環境へのデプロイ

対象環境向けの引数を利用してアプリをデプロイするスキル:
@skills:deploy staging で呼び出すと、staging が $ARGUMENTS と $1 に置き換えられます。triggers: ["user"] フィールドにより、Devin は明示的に依頼した場合にのみこのスキルを実行し、自動では有効になりません。

コードベースの一部を調査する

読み取り専用ツールを事前承認した状態で、ガイド付きのコード探索を行うためのスキル:
allowed-tools フィールドを指定すると、スキルがアクティブな間、Devin は記載されたツールを権限の確認なしで利用できます。それ以外のツールも引き続き利用できますが、通常どおり権限プロンプトが表示されます。ツールを完全にブロックするには、permissions: { deny: [...] } を利用してください (後述) 。

ウェブアプリでスキルを作成する

スキルの作成にリポジトリは必要ありません。Customize ページで スキル タブを開き、ページタイトルのメニューからスキルの対象を選択します。対象は Myself (自分のみ) 、組織名、Enterprise (エンタープライズ内のすべての組織) のいずれかです。次に + (New skill) をクリックします。スキルの SKILL.md を編集するエディターが開くので、保存すると、そのスコープ内のすべての新規セッションでスキルを利用できるようになります。後から同じ場所で編集でき、保存のたびに Version history が残ります。 Devin には独自の built-in スキル (たとえば implement、plan、triage、review) が System スキル プラグインとして同梱されており、すべてのユーザーにインストールされています。 スキルを探すには、Search スキル (タブ右上の虫眼鏡アイコン) をクリックしてキーワードを入力します。入力に応じてリストが絞り込まれます。 スキル名は、どこからスキルを呼び出す場合にも共通で使います。prompt ボックス、Slack、API の prompt では @skills:<name> と記述します。Jira や Linear のラベル、スケジュール、自動化 でも、同じ方法でスキルを指定します。

良いスキルの書き方

スキルは、新しいチームメンバーへの指示のように書くと最も効果的です。
  • 手順: 1 行に 1 ステップずつ命令形で記述し、セットアップ、タスク本体、成果物の納品までを網羅します。各ステップには動作を表す動詞 (write、run、open など) を含め、ステップ全体で重複なくタスク全体をカバーするようにします。
  • 仕様: Devin の作業完了時に満たされているべき条件です。これにより、Devin が自身の作業をチェックできます。
  • Advice: タスク全体に適用される好みや修正点です。特定のステップにのみ関するアドバイスは、そのステップの下に記述します。
  • 禁止事項: Devin が決して行ってはならないことです。
  • ユーザーに必須の提供事項: Devin が自力では取得できないトークン、リンク、または判断事項です。
特定のコマンド、フラグ、文字列は積極的に記述してください。これらがスキルの成否を分けることも少なくありません。一方、それ以外の部分は細かく指定しすぎないようにしてください。詳細が多すぎると、Devin が作業の途中で自ら問題を解決する力が損なわれます。新しいスキルで 2 つのセッションを並列で実行すると、不足点をすばやく洗い出せます。また、セッションの途中で Devin が助けを求めてきた場合は、伝えた内容をスキルに追加し、次のセッションでは同じ助けが不要になるようにしましょう。Devin に過去のセッションからスキルを作成または改善するよう依頼することもできます。

スキルの検出

Devin は 2 つのソースからスキルを検出します。
  1. リポジトリ — 各リポジトリがセッションのマシンにクローンされるたびに、Devin はそのリポジトリ内のディスク上にある SKILL.md ファイルをスキャンします。そのため、Devin は常に作業中のブランチにあるバージョンを参照します。セッションの途中でクローンされたリポジトリは、クローンが完了した時点でスキャンされるため、セッションを再起動する必要はありません。
  2. プラグイン — 組織向けにインストールされたプラグインに含まれるスキルは、セッションの開始直後から、リポジトリがクローンされる前でも利用できます。

サポートされているスキルファイルの配置場所

Devin は、次のすべてのディレクトリで SKILL.md ファイルを検索します:
  • .agents/skills/<skill-name>/SKILL.md (推奨)
  • .devin/skills/<skill-name>/SKILL.md
  • .github/skills/<skill-name>/SKILL.md
  • .claude/skills/<skill-name>/SKILL.md
  • .cognition/skills/<skill-name>/SKILL.md
  • .windsurf/skills/<skill-name>/SKILL.md
  • .cursor/skills/<skill-name>/SKILL.md
  • .codex/skills/<skill-name>/SKILL.md
  • .codeium/skills/<skill-name>/SKILL.md
  • .kiro/skills/<skill-name>/SKILL.md
すべてのリポジトリで、これら 10 個のパスがスキャンされます。

スキルファイルから Devin が読み込むもの

スキルが検出されると、Devin は YAML の frontmatter (先頭の --- ブロック) をパースして、次の項目を抽出します。 Devin は、標準仕様に加えて、次の追加の frontmatter フィールドもサポートします。 frontmatter の後に続くすべての内容がスキル本文です。これは、スキルが呼び出されたときに Devin が読み込む指示です。 完全なファイル形式のリファレンスについては、Agent Skills specification を参照してください。

Devin がスキルをどのように利用するか

各セッションの開始時に、Devin は利用可能なすべてのスキルのリスト (名前+説明) を確認します。スキルが呼び出されると、Devin は対応する SKILL.md ファイル全体を読み、その内容を会話のコンテキストに追加します。追加された内容はセッションが終わるまで保持されます — 単なる参照ではなく、Devin の振る舞いを直接ガイドします。内容がすでにコンテキストに含まれているスキルを呼び出しても、重複して追加されることはありません。 Devin は複数の方法でスキルを使用できます:

自動呼び出し

Devin が現在のタスクに対してスキルが関連していると判断した場合、そのスキルは自動的に呼び出されます。たとえば、Devin にフロントエンドコードのバグ修正を依頼していて、test-before-pr というスキルが存在する場合、Devin は PR を作成する前にそのスキルを有効化します。明示的にのみ呼び出したいスキルで自動呼び出しを無効化するには、frontmatter で triggers: ["user"] を設定してください。

プロンプトでスキルを指定する

メッセージ内に @skills:skill-name を含めることで、Devinに特定のスキルを使うよう指示できます。
引数を指定することもできます。
引数は、スキル本体内でプレースホルダーが現れる箇所に置き換えられます。$ARGUMENTS は引数文字列全体に、$1 から $9 は空白で区切られた個々の引数に置き換えられます (不足している引数は空文字列になります) 。スキル本体にプレースホルダーが含まれていない場合は、引数がスキルの内容の末尾に追加されます。$0、$10 以降、および $HOME のようなその他のドル記号を含む式はそのまま残されます。

複数のスキルを組み合わせて使用する

スキルを呼び出しても、以前に呼び出したスキルが置き換えられることはありません。呼び出すたびにそのスキルの本文が Devin のコンテキストに追加されるため、1 つの prompt で 2 つのスキルに言及した場合 (または後から 2 つ目のスキルを呼び出した場合) でも最初のスキルはそのまま残り、Devin は両方に従います。各スキルの allowed-tools と permissions は、そのスキルが呼び出された時点で有効になり、それ以降も引き続き適用されます。

検索と一覧表示

Devin は、セッションの途中で適切なスキルを見つける必要がある場合、利用可能なスキルを一覧表示したり、プロジェクトのディレクトリやアクティブなプラグインから他のスキルを検索したりできます。

スキルの利用頻度を確認する

設定 > 分析 では、各スキルの利用頻度を確認できます。Customize > スキル にあるグラフアイコンから、このビューを直接開くこともできます。表示するには、組織のメトリクスを閲覧する権限が必要です。 このビューには、1 日あたりのスキル呼び出し回数のグラフと、呼び出し回数の多いスキルのランキングが表示されます。また、スキルごとに 呼び出し回数、セッション、ユーザー、最終利用日時 が一覧表示されます。

スキルとプレイブックの違い

新しい作業にはすべてスキルを利用してください。プレイブックはスキルへ移行中です。あなたのアカウントが移行されると、各プレイブックは同じ指示を持つスキルに変換され、プレイブックのページは read-only になり、Playbooks API はスキルに対して読み書きを行うようになります。2026年10月24日以降に作成される新しいアカウントは、最初からスキルのみを利用し、プレイブックはありません。詳しくは プレイブックはスキルへ移行中です を参照してください。

スキルとメモリの違い

スキルは、ユーザーが意図的に作成する手順です。一方、メモリは、作業を通じて Devin がユーザーの好みやプロジェクトについて学習した内容です。メモリは自動的に保存され、ユーザー個人に紐づきます。

詳細情報

  • Agent Skills specification — SKILL.md ファイル形式、frontmatter フィールド、ディレクトリ構造に関するオープンスタンダード
  • プレイブック — 現在もプレイブックを利用しているアカウント向け