スキルとは何ですか?
スキルは、リポジトリにコミットする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” ボタン
例
PR を作成する前のテスト
PR を作成する前に Next.js アプリを検証する方法を Devin に指示するスキル:環境へのデプロイ
動的な内容の挿入を行いながら、対象環境向けの引数を利用してアプリをデプロイするスキル:@skills:deploy staging で呼び出すと、staging が $ARGUMENTS と $1 に置き換えられ、!`command` ブロックによってその時点の Git 情報が挿入されます。triggers: ["user"] フィールドにより、Devin は明示的に依頼した場合にのみこのスキルを実行し、自動では有効になりません。
コードベースの一部を調査する
Devin が読み取り専用ツールのみに制限された状態で、ガイド付きのコード探索を行うためのスキル:allowed-tools フィールドは、スキルが有効な間に Devin が利用するツールを読み取り専用の操作に制限します — 編集やシェルコマンドの実行はできません。これは、副作用を伴わずに分析したい探索タスクで役立ちます。
スキルの検出
- インデックス済みリポジトリ — Devin のバックエンドは、組織に接続されているすべてのリポジトリにある
SKILL.mdファイルをインデックス化します。これらは、どのリポジトリもクローンされる前の、セッション開始時点からすぐに利用できます。 - クローンされたリポジトリ — リポジトリがセッションのマシンにクローンされると、Devin はディスク上の
SKILL.mdファイルをスキャンします。ディスクから検出されたスキルは、同じリポジトリ内の該当するインデックス済みスキルを更新または上書きし、作業中のブランチで常に最新バージョンが使われるようにします。
サポートされているスキルファイルの配置場所
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
スキルファイルから Devin が読み込むもの
スキルが検出されると、Devin は YAML の frontmatter (先頭の--- ブロック) をパースして、次の項目を抽出します。
Devin は、標準仕様に加えて、次の追加の frontmatter フィールドもサポートします。
frontmatter の後に続くすべての内容がスキル本体です。これは、スキルが呼び出されたときに Devin が従うようプロンプトされるステップごとの手順です。
完全なファイル形式のリファレンスについては、Agent Skills specification を参照してください。
Devin がスキルをどのように利用するか
SKILL.md ファイル全体を読み、その内容を現在のコンテキストにシステムレベルの指示として取り込みます。これは、Devin がタスクの残りの間、そのスキルで定義された手順に積極的に従うことを意味します — 単なる参照ではなく、Devin の振る舞いを直接ガイドします。
Devin は複数の方法でスキルを使用できます:
自動呼び出し
test-before-pr というスキルが存在する場合、Devin は PR を作成する前にそのスキルを有効化します。明示的にのみ呼び出したいスキルで自動呼び出しを無効化するには、frontmatter で triggers: ["user"] を設定してください。
プロンプトでスキルを指定する
メッセージ内に@skills:skill-name を含めることで、Devinに特定のスキルを使うよう指示できます。
$ARGUMENTS は引数文字列全体に、$1 から $9 は空白で区切られた個々の引数に置き換えられます (不足している引数は空文字列になります) 。スキル本体にプレースホルダーが含まれていない場合は、引数がスキルの内容の末尾に追加されます。$0、$10 以降、および $HOME のようなその他のドル記号を含む式はそのまま残されます。
一度にアクティブにできるスキルは 1 つ
検索と一覧表示
制限事項
- 複数スキルの組み合わせ — 現在は一度にアクティブにできるスキルは 1 つだけです。スキルの連結やワークフローの合成をサポートする機能を開発中です。
スキルとプレイブックの違い
スキルとプレイブックはどちらも Devin に再利用可能な指示を与えるための仕組みですが、動作は異なります。
どちらを使うべきですか? 手順が特定のリポジトリに紐づいている (実行方法、テスト方法、デプロイ方法など) 場合は、スキルを使ってください。手順がリポジトリやチームをまたいで適用できる汎用的なプロンプトであれば、プレイブックを使ってください。
スキルとメモリの違い
スキルは、ユーザーが意図的に作成する手順です。一方、メモリは、作業を通じて Devin がユーザーの好みやプロジェクトについて学習した内容です。メモリは自動的に保存され、ユーザー個人に紐づきます。詳細情報
- Agent Skills specification —
SKILL.mdファイル形式、frontmatter フィールド、ディレクトリ構造に関するオープンスタンダード - プレイブック — セッションに紐づけて再利用できるプロンプトテンプレート向け

