Skills は、リポジトリにコミットする SKILL.md ファイルで、Devin にあなたのアプリケーションをエンドツーエンドでテストする方法——サービスの起動方法、ローカルでのアプリの実行方法、ブラウザーでの変更内容の確認方法、そして PR を作成する前にすべてが正しく動作していることを検証する方法——を教えるものです。オープンな Agent Skills standard に準拠しているため、同じ skill ファイルを複数の AI コーディングツール間で共通して利用できます。
リポジトリ内の .agents/skills/<skill-name>/SKILL.md に skill ファイルを配置してください。Devin は、接続されているすべてのリポジトリからそれらを自動的に検出します。ファイル形式の詳細については、Agent Skills specification を参照してください。
スキルがない場合、Devin はセッションのたびに、あなたのアプリをどう実行・テストするかを一から把握する必要があります。スキルがあれば、Devin は次のことを正確に把握できます:
- ローカル開発環境を起動する — どのサービスを動かすか、どのポートを使うか、テストデータをどう投入するか
- ブラウザで変更を検証する — どのページを確認するか、何が「正しい」状態か、どのような不具合を検知すべきか
- 適切なテストスイートを実行する — どのコマンドを実行するか、成功時の出力がどう見えるか
Devin はスキルを自動で提案します。Devin がアプリケーションをテストしたり、セッション中にセットアップについて新しいことを学習したりすると、その知識を取り込むためのスキルを作成または更新することを提案します。セッションのタイムラインには、次の内容を含む提案が表示されます:
- 学習内容の要約（例: 「Docker でバックエンドを起動する方法」）
- 提案された
SKILL.md ファイルの内容
- スキルをリポジトリにコミットするための “Create PR” ボタン
時間の経過とともに、Devin はリポジトリ内に、アプリケーションの実行方法やテスト方法に関するスキルのライブラリを蓄積していきます。
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
- インデックス済みリポジトリ — 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
すべてのリポジトリで、これら 6 つのパスがスキャンされます。
スキルが検出されると、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` — コマンドはリポジトリのルートで実行され、その標準出力に置き換えられます。これにより、ブランチ名やポート番号などの動的な値をスキルに含めることができます。
たとえば、デプロイスキルは次のように引数を使うことができます。
---
name: deploy
description: Deploy the app to a target environment.
argument-hint: <environment>
---
1. Check out the `$ARGUMENTS` branch
2. Run `./scripts/deploy.sh $0`
3. Verify the deployment at `https://$0.example.com`
@skills:deploy staging を実行すると、staging が $ARGUMENTS および $0 に置き換えられます。
各セッションの開始時に、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 がアプリをテストしたり新しいことを学習した後に、新しいスキルを提案する | チームメンバーが手動で作成する |
| 適している用途 | テスト手順、ローカル開発環境のセットアップ、デプロイチェックリスト、リポジトリ固有のワークフロー | 再利用可能なプロンプトテンプレート、複数リポジトリにまたがるタスクパターン、オンボーディングガイド |
すでにうまく機能しているプレイブックがある場合、急いで移行する必要はありません — 引き続き動作します。ただし、新しい手順については、スキルから始めることをおすすめします。
