難易度の高いエンジニアリング作業では、優れたプロンプトだけでは足りないことが少なくありません。参照用スクリプト、テンプレート、チェックリスト、その他の補助ファイルが必要になる場合もあります。スキルを使うと、これらをまとめて、Cascade が呼び出して利用できるフォルダーとして整理できます。
スキルは、Cascade に複数ステップのワークフローを一貫して実行する方法を教えるための優れた手段です。
Cascade は 段階的開示 を採用しています。デフォルトでは、モデルに表示されるのはスキルの name と description だけです。完全な SKILL.md の内容と補助ファイルが読み込まれるのは、Cascade がそのスキルを呼び出すと判断したとき (または @mention したとき) だけです。これにより、多数のスキルを定義していても、前提情報のウィンドウをコンパクトに保てます。
スキル仕様の詳細については、agentskills.io を参照してください。
- Cascade パネルを開きます
- パネル右上の三点アイコンをクリックして、カスタマイズメニューを開きます
Skills セクションをクリックします+ Workspace をクリックして workspace (プロジェクト固有) のスキルを作成するか、+ Global をクリックしてグローバルスキルを作成します- スキルに名前を付けます (使用できるのは小文字、数字、ハイフンのみです)
Workspace Skill (プロジェクト固有) :
- ディレクトリを作成します:
.windsurf/skills/<skill-name>/
- YAMLフロントマター付きの
SKILL.md ファイルを追加します
Global Skill (すべてのワークスペースで利用可能) :
- ディレクトリを作成します:
~/.codeium/windsurf/skills/<skill-name>/
- YAMLフロントマター付きの
SKILL.md ファイルを追加します
各スキルには、スキルのメタデータを含む YAML フロントマターを持つ SKILL.md ファイルが必要です:
---
name: deploy-to-production
description: Guides the deployment process to production with safety checks
---
## Pre-deployment Checklist
1. Run all tests
2. Check for uncommitted changes
3. Verify environment variables
## Deployment Steps
Follow these steps to deploy safely...
[Reference supporting files in this directory as needed]
- name: スキルの一意の識別子 (UIに表示され、@メンションでも使用されます)
- description: モデルがそのスキルをいつ呼び出すべきか判断できるように表示される、簡潔な説明
有効な名前の例: deploy-to-staging, code-review, setup-dev-environment
SKILL.md と同じ スキル フォルダに、必要な補助ファイルを配置します。これらのファイルは、スキル の呼び出し時に Cascade から利用できるようになります。
.windsurf/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
description フィールドは重要です。このフィールドによって、Cascade はどのタイミングでそのスキルを呼び出すべきかを判断できます。説明文には、そのスキルで何ができるのか、どのような場合に利用すべきかが明確に伝わるように記述してください。
Cascade の入力欄に @skill-name と入力すると、いつでも明示的にスキルを有効化できます。これは、特定のスキルを確実に利用したい場合や、リクエストでは自動的にトリガーされない可能性があるスキルを呼び出したい場合に便利です。
| スコープ | 場所 | 利用可能範囲 |
|---|
| ワークスペース | .windsurf/skills/ | 現在のワークスペースのみ。リポジトリと一緒にコミットされます。 |
| グローバル | ~/.codeium/windsurf/skills/ | お使いのマシン上のすべてのワークスペース。コミットされません。 |
| システム (Enterprise) | OS によって異なります (以下を参照) | すべてのワークスペース。IT によって配布されます。読み取り専用。 |
エージェント間の互換性のため、Devin Desktop は .agents/skills/ と ~/.agents/skills/ 内のスキルも検出します。Claude Code の設定の読み取りを有効にしている場合は、.claude/skills/ と ~/.claude/skills/ もスキャンされます。
| OS | Path |
|---|
| macOS | /Library/Application Support/Windsurf/skills/ |
| Linux/WSL | /etc/windsurf/skills/ |
| Windows | C:\ProgramData\Windsurf\skills\ |
SKILL.md ファイルを含むサブディレクトリになっています。
デプロイスクリプト、環境設定、ロールバック手順を含むスキルを作成します：
.windsurf/skills/deploy-staging/
├── SKILL.md
├── pre-deploy-checks.sh
├── environment-template.env
└── rollback-steps.md
.windsurf/skills/code-review/
├── SKILL.md
├── style-guide.md
├── security-checklist.md
└── review-template.md
.windsurf/skills/run-tests/
├── SKILL.md
├── test-template.py
├── coverage-config.json
└── ci-workflow.yaml
-
明確な説明を書く: 説明は、Cascade がそのスキルをいつ呼び出すべきかを判断するのに役立ちます。スキルの内容と、どのような場合に利用すべきかを具体的に記述してください。
-
関連するリソースを含める: テンプレート、チェックリスト、使用例があると、スキルはより便利になります。そのタスクを完了するうえで役立つファイルは何かを考えてください。
-
わかりやすい名前を付ける:
deploy-to-staging は deploy1 より適切です。名前を見れば、そのスキルが何をするものかがすぐにわかるようにしてください。
いずれも Cascade をカスタマイズするものですが、構造、呼び出し方法、前提情報コストが異なります。
| スキル | ルール | ワークフロー |
|---|
| 目的 | 補助ファイルを伴う複数ステップの手順 | 振る舞いのガイドライン (「どう振る舞うか」) | 繰り返し使うタスク向けのプロンプトテンプレート |
| 構造 | SKILL.md と任意のリソースファイルを含むフォルダー | フロントマター を含む単一の .md ファイル | 単一の .md ファイル |
| 呼び出し | モデルが決定 (段階的開示) または @mention | always_on / glob / model_decision / manual | /slash-command での手動のみ |
| システムプロンプト内? | いいえ — 呼び出されるまでは名前と説明のみ | 有効化モードによる | いいえ — 利用可能なコマンドとして一覧表示される |
| 最適な用途 | スクリプトやテンプレートが必要なデプロイ、コードレビュー、テスト手順 | コーディングスタイル、プロジェクトの慣例、制約 | 明示的にトリガーする単発のランブック |
- ワークフロー - スラッシュコマンドで呼び出せる再利用可能な Markdown ワークフローを使って、反復的なタスクを自動化します
- AGENTS.md - ファイルの場所に応じて自動的に適用される、ディレクトリ単位の指示を与えます
- Memories & ルール - 自動生成される Memories とユーザー定義のルールによって、会話をまたいで前提情報を保持します
