スキルは、リポジトリにコミットする SKILL.md ファイルで、Devin に再利用可能な手順——つまり、Devin に一貫して従わせたい、繰り返し可能なあらゆるワークフロー——を教えるものです。PR を作成する前のアプリのテスト、環境へのデプロイ、コードベースの調査、新しいサービスのひな形作成など、ステップごとの手順として書けるものであれば、スキルにできます。
オープンな Agent Skills standard に準拠しているため、同じスキルファイルを複数の AI コーディングツール間で共通して利用できます。
リポジトリ内の .agents/skills/<skill-name>/SKILL.md にスキルファイルを配置してください。Devin は、接続されているすべてのリポジトリからそれらを自動的に検出します。完全なファイル形式のリファレンスについては、Agent Skills specification を参照してください。
スキルがないと、Devin は毎回のセッションごとにワークフローをゼロから把握しなければなりません。スキルがあれば、手順を一度定義するだけで、Devin は毎回確実にその手順に従います。スキルは、次のようなワークフローで特に役立ちます。
- 毎回同じやり方で実行する必要がある — テストのチェックリスト、デプロイ手順、レビュー手順
- リポジトリ固有の知識が必要である — 起動するサービス、使用するポート、実行するコマンド
- 動的なコンテキストを活用すると効果的である — 呼び出し時に git diff、ブランチ名、環境情報を取り込む
Devin はスキルを自動で提案します。Devin がアプリケーションをテストしたり、セッション中にセットアップについて新しいことを学習したりすると、その知識を取り込むためのスキルを作成または更新することを提案します。セッションのタイムラインには、次の内容を含む提案が表示されます:
- 学習内容の要約 (例: 「Docker でバックエンドを起動する方法」)
- 提案された
SKILL.md ファイルの内容
- スキルをリポジトリにコミットするための “Create PR” ボタン
時間の経過とともに、Devin はリポジトリ内に、アプリケーションの実行方法、テスト方法、デプロイ方法に関するスキルのライブラリを蓄積していきます。
PR を作成する前に Next.js アプリを検証する方法を Devin に指示するスキル:
---
name: test-before-pr
description: Run the local dev server and verify pages before opening any PR that touches frontend code.
---
## Setup
1. Install dependencies: `npm install`
2. Start the database: `docker-compose up -d postgres`
3. Run migrations: `npx prisma migrate dev`
4. Start the dev server: `npm run dev`
5. Wait for "Ready on http://localhost:3000"
## Verify
1. Read the git diff to identify which pages changed
2. Open each affected page in the browser
3. Check for: console errors, layout issues, broken links
4. Screenshot each page at desktop (1280px) and mobile (375px) widths
## Before Opening the PR
1. Run `npm run lint` and fix any issues
2. Run `npm test` and confirm all tests pass
3. Include screenshots in the PR description
---
name: deploy
description: Deploy the app to a target environment and run smoke tests.
argument-hint: <environment>
triggers: ["user"]
---
## Deploy
1. Make sure you are on the correct branch for this deploy
2. Run `./scripts/deploy.sh $0`
3. Wait for the deploy script to complete successfully
## Verify
1. Curl `https://$0.example.com/health` and confirm a 200 response
2. Run the smoke test suite: `npm run test:smoke -- --env=$0`
3. Report the deployment URL and test results
## Current context
- Branch: !`git branch --show-current`
- Last commit: !`git log --oneline -1`
@skills:deploy staging で呼び出すと、staging が $ARGUMENTS と $0 に置き換えられ、!`command` ブロックによってその時点の Git 情報が挿入されます。triggers: ["user"] フィールドにより、Devin は明示的に依頼した場合にのみこのスキルを実行し、自動では有効になりません。
Devin が読み取り専用ツールのみに制限された状態で、ガイド付きのコード探索を行うためのスキル:
---
name: investigate
description: Research a part of the codebase and produce a written summary with file references.
allowed-tools: Read, Grep, ListDir
argument-hint: <topic or area to investigate>
---
## Research
1. Search the codebase for files related to: $ARGUMENTS
2. Read the most relevant files thoroughly
3. Trace the call chain and data flow
## Summarize
1. Write a summary of how $ARGUMENTS works
2. Include specific file paths and line numbers for every claim
3. Note any concerns, edge cases, or areas that need attention
allowed-tools フィールドは、スキルが有効な間に Devin が利用するツールを読み取り専用の操作に制限します — 編集やシェルコマンドの実行はできません。これは、副作用を伴わずに分析したい探索タスクで役立ちます。
Devin は、各セッションの開始時に 2 つのソースからスキルを取得し、統合します。
- インデックス済みリポジトリ — Devin のバックエンドは、組織に接続されているすべてのリポジトリにある
SKILL.md ファイルをインデックス化します。これらは、どのリポジトリもクローンされる前の、セッション開始時点からすぐに利用できます。
- クローンされたリポジトリ — リポジトリがセッションのマシンにクローンされると、Devin はディスク上の
SKILL.md ファイルをスキャンします。ディスクから検出されたスキルは、同じリポジトリ内の該当するインデックス済みスキルを更新または上書きし、作業中のブランチで常に最新バージョンが使われるようにします。
リポジトリのクローンがセッション途中で完了した場合でも、Devin はそのリポジトリを自動的に再スキャンし、新しく追加または変更されたスキルを、セッションを再起動することなく取り込みます。
Devin は、次のすべてのディレクトリで SKILL.md ファイルを検索します：
.agents/skills/<skill-name>/SKILL.md (推奨) .github/skills/<skill-name>/SKILL.md.claude/skills/<skill-name>/SKILL.md.cursor/skills/<skill-name>/SKILL.md.codex/skills/<skill-name>/SKILL.md.cognition/skills/<skill-name>/SKILL.md.windsurf/skills/<skill-name>/SKILL.md
すべてのリポジトリで、これら 7 つのパスがスキャンされます。
スキルが検出されると、Devin は YAML の frontmatter (先頭の --- ブロック) をパースして、次の項目を抽出します。
| Field | Purpose |
|---|
name | スキルを識別します。省略された場合は親ディレクトリ名が代わりに使われます。 |
description | スキル一覧に表示される短い要約で、Devin (とあなた) がそのスキルの内容を理解できるようにします。 |
allowed-tools | スキルがアクティブな間に Devin が利用できるツールを制限します。 |
| Field | Purpose |
|---|
argument-hint | 期待される引数を説明するヒントテキストで、スキル名と一緒に表示されます。 |
triggers | 誰がスキルを呼び出せるかを制御します — デフォルトは ["user", "model"] です。Devin が自動的に有効化するのを防ぐには ["user"] に設定します。 |
$ARGUMENTS — スキル呼び出し時に渡された引数文字列全体 (例: @skills:deploy staging prod) に置き換えられます。個々の引数にはインデックスでアクセスできます：1 番目は $ARGUMENTS[0] または $0、2 番目は $ARGUMENTS[1] または $1 など。引数は空白で分割されます。!`command` — コマンドはリポジトリのルートで実行され、その標準出力に置き換えられます。これにより、ブランチ名やポート番号などの動的な値をスキルに含めることができます。
各セッションの開始時に、Devin は利用可能なすべてのスキルのリスト (名前＋説明) を確認します。スキルが呼び出されると、Devin は対応する SKILL.md ファイル全体を読み、その内容を現在のコンテキストにシステムレベルの指示として取り込みます。これは、Devin がタスクの残りの間、そのスキルで定義された手順に積極的に従うことを意味します — 単なる参照ではなく、Devin の振る舞いを直接ガイドします。
Devin は複数の方法でスキルを使用できます：
Devin が現在のタスクに対してスキルが関連していると判断した場合、そのスキルは自動的に呼び出されます。たとえば、Devin にフロントエンドコードのバグ修正を依頼していて、test-before-pr というスキルが存在する場合、Devin は PR を作成する前にそのスキルを有効化します。明示的にのみ呼び出したいスキルで自動呼び出しを無効化するには、frontmatter で triggers: ["user"] を設定してください。
メッセージ内に @skills:skill-name を含めることで、Devinに特定のスキルを使うよう指示できます。
Fix the login bug on the /auth page @skills:test-before-pr
$ARGUMENTS、$ARGUMENTS[0]、$1 などが現れる箇所に置き換えられます。
Devin が同時にアクティブにできるスキルは 1 つだけです。新しいスキルを起動すると、それまでのスキルは置き換えられます。スキルがアクティブな間、Devin はそのスキルの手順に従って順番に処理し、次に進む前に各ステップを完了するよう求められます。
Devin は、セッションの途中でも適切なスキルを見つける必要がある場合、キーワードやディレクトリを指定してスキルを検索できます。利用可能なスキルの一覧を Devin に表示させたり、スキルファイルに変更をプッシュした後で再読み込みさせたりすることもできます。
- グローバル / 組織レベルのスキル — 現時点では、スキルはリポジトリ内に存在します。組織全体で使うスキルについては、回避策として専用の「skills」リポジトリを作成できます。すべてのリポジトリに適用される組織レベルのスキルを、ファーストクラスでサポートすることを検討中です。
- 複数スキルの組み合わせ — 現在は一度に有効にできるスキルは 1 つだけです。スキルの連結やワークフローの合成をサポートする機能を開発中です。
スキルとプレイブックはどちらも Devin に再利用可能な指示を与えるための仕組みですが、動作は異なります。
| Skills | Playbooks |
|---|
| 保存場所 | リポジトリ内の SKILL.md ファイル — コードと一緒にバージョン管理される | Devin の Web アプリ内 — UI を通じて管理される |
| トリガー方法 | Devin が自動的に検出して実行するか、任意のプロンプトで @skills:name として参照する | セッション開始時に手動で紐づける |
| スコープ | リポジトリ単位 — Devin はタスクに関連するリポジトリに基づいて適切なスキルを選択する | 組織全体 — どのチームメンバーでも任意のプレイブックを任意のセッションに紐づけられる |
| 自動提案 | Devin がアプリをテストしたり新しいことを学習した後に、新しいスキルを提案する | チームメンバーが手動で作成する |
| 適している用途 | テスト手順、ローカル開発環境のセットアップ、デプロイチェックリスト、リポジトリ固有のワークフロー | 再利用可能なプロンプトテンプレート、複数リポジトリにまたがるタスクパターン、オンボーディングガイド |
すでにうまく機能しているプレイブックがある場合、急いで移行する必要はありません — 引き続き動作します。ただし、新しい手順については、スキルから始めることをおすすめします。
