難易度の高いエンジニアリング作業では、優れたプロンプトだけでは足りないことが少なくありません。参照用スクリプト、テンプレート、チェックリスト、その他の補助ファイルが必要になる場合もあります。スキルを使うと、これらをまとめて、Cascade が呼び出して利用できるフォルダーとして整理できます。 スキルは、Cascade に複数ステップのワークフローを一貫して実行する方法を教えるための優れた手段です。 Cascade は 段階的開示 を採用しています。デフォルトでは、モデルに表示されるのはスキルのDocumentation Index
Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
Use this file to discover all available pages before exploring further.
name と description だけです。完全な SKILL.md の内容と補助ファイルが読み込まれるのは、Cascade がそのスキルを呼び出すと判断したとき (または @mention したとき) だけです。これにより、多数のスキルを定義していても、前提情報のウィンドウをコンパクトに保てます。
スキル仕様の詳細については、agentskills.io を参照してください。
スキルの作成方法
UI を使う方法 (最も簡単)
- Cascade パネルを開きます
- パネル右上の三点アイコンをクリックして、カスタマイズメニューを開きます
Skillsセクションをクリックします+ Workspaceをクリックして workspace (プロジェクト固有) のスキルを作成するか、+ Globalをクリックしてグローバルスキルを作成します- スキルに名前を付けます (使用できるのは小文字、数字、ハイフンのみです)
手動作成
- ディレクトリを作成します:
.windsurf/skills/<skill-name>/ - YAMLフロントマター付きの
SKILL.mdファイルを追加します
- ディレクトリを作成します:
~/.codeium/windsurf/skills/<skill-name>/ - YAMLフロントマター付きの
SKILL.mdファイルを追加します
SKILL.md ファイル形式
SKILL.md ファイルが必要です:
スキルの例
必須のFrontmatterフィールド
- name: スキルの一意の識別子 (UIに表示され、@メンションでも使用されます)
- description: モデルがそのスキルをいつ呼び出すべきか判断できるように表示される、簡潔な説明
deploy-to-staging, code-review, setup-dev-environment
補助リソースの追加
SKILL.md と同じ スキル フォルダに、必要な補助ファイルを配置します。これらのファイルは、スキル の呼び出し時に Cascade から利用できるようになります。
スキルを呼び出す
自動呼び出し
description フィールドは重要です。このフィールドによって、Cascade はどのタイミングでそのスキルを呼び出すべきかを判断できます。説明文には、そのスキルで何ができるのか、どのような場合に利用すべきかが明確に伝わるように記述してください。
手動での呼び出し
@skill-name と入力すると、いつでも明示的にスキルを有効化できます。これは、特定のスキルを確実に利用したい場合や、リクエストでは自動的にトリガーされない可能性があるスキルを呼び出したい場合に便利です。
スキルのスコープ
| スコープ | 場所 | 利用可能範囲 |
|---|---|---|
| ワークスペース | .windsurf/skills/ | 現在のワークスペースのみ。リポジトリと一緒にコミットされます。 |
| グローバル | ~/.codeium/windsurf/skills/ | お使いのマシン上のすべてのワークスペース。コミットされません。 |
| システム (Enterprise) | OS によって異なります (以下を参照) | すべてのワークスペース。IT によって配布されます。読み取り専用。 |
エージェント間の互換性のため、Devin Desktop は
.agents/skills/ と ~/.agents/skills/ 内のスキルも検出します。Claude Code の設定の読み取りを有効にしている場合は、.claude/skills/ と ~/.claude/skills/ もスキャンされます。システムレベルのスキル (Enterprise)
| OS | Path |
|---|---|
| macOS | /Library/Application Support/Windsurf/skills/ |
| Linux/WSL | /etc/windsurf/skills/ |
| Windows | C:\ProgramData\Windsurf\skills\ |
SKILL.md ファイルを含むサブディレクトリになっています。
使用例
デプロイワークフロー
コードレビューのガイドライン
テスト手順
ベストプラクティス
- 明確な説明を書く: 説明は、Cascade がそのスキルをいつ呼び出すべきかを判断するのに役立ちます。スキルの内容と、どのような場合に利用すべきかを具体的に記述してください。
- 関連するリソースを含める: テンプレート、チェックリスト、使用例があると、スキルはより便利になります。そのタスクを完了するうえで役立つファイルは何かを考えてください。
-
わかりやすい名前を付ける:
deploy-to-stagingはdeploy1より適切です。名前を見れば、そのスキルが何をするものかがすぐにわかるようにしてください。
スキル vs ルール vs ワークフロー
| スキル | ルール | ワークフロー | |
|---|---|---|---|
| 目的 | 補助ファイルを伴う複数ステップの手順 | 振る舞いのガイドライン (「どう振る舞うか」) | 繰り返し使うタスク向けのプロンプトテンプレート |
| 構造 | SKILL.md と任意のリソースファイルを含むフォルダー | フロントマター を含む単一の .md ファイル | 単一の .md ファイル |
| 呼び出し | モデルが決定 (段階的開示) または @mention | always_on / glob / model_decision / manual | /slash-command での手動のみ |
| システムプロンプト内? | いいえ — 呼び出されるまでは名前と説明のみ | 有効化モードによる | いいえ — 利用可能なコマンドとして一覧表示される |
| 最適な用途 | スクリプトやテンプレートが必要なデプロイ、コードレビュー、テスト手順 | コーディングスタイル、プロジェクトの慣例、制約 | 明示的にトリガーする単発のランブック |
- ワークフロー - スラッシュコマンドで呼び出せる再利用可能な Markdown ワークフローを使って、反復的なタスクを自動化します
- AGENTS.md - ファイルの場所に応じて自動的に適用される、ディレクトリ単位の指示を与えます
- Memories & ルール - 自動生成される Memories とユーザー定義のルールによって、会話をまたいで前提情報を保持します
