最も難しいエンジニアリングタスクでは、優れたプロンプトだけでは足りないことがよくあります。参照用スクリプト、テンプレート、チェックリスト、その他のサポートファイルが必要になることもあります。スキルを使うと、これらをすべてフォルダにまとめて、Cascade が呼び出せる (読み取って利用できる) ようにできます。
スキルは、Cascade に複数ステップのワークフローを一貫して実行する方法を教えるための優れた手段です。
Cascade は 段階的開示 を使用します。デフォルトでは、モデルに表示されるのはスキルの name と description のみです。SKILL.md の完全な内容とサポートファイルが読み込まれるのは、Cascade がそのスキルを呼び出すと判断したとき (または @mention したとき) だけです。これにより、多数のスキルを定義していてもコンテキストウィンドウをスリムに保てます。
Skills の仕様の詳細については、agentskills.io を参照してください。
- Cascade パネルを開きます
- パネル右上の三点アイコンをクリックして、Customizations メニューを開きます
Skills セクションをクリックします+ Workspace をクリックしてプロジェクト固有のワークスペーススキルを作成するか、+ Global をクリックしてグローバルスキルを作成します- スキルに名前を付けます（小文字のアルファベット、数字、ハイフンのみ使用可能）
ワークスペーススキル（プロジェクト固有）:
- ディレクトリを作成します:
.windsurf/skills/<skill-name>/
- YAML フロントマターを含む
SKILL.md ファイルを追加します
グローバルスキル（すべてのワークスペースで利用可能）:
- ディレクトリを作成します:
~/.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: Skill の一意な識別子（UI に表示され、@メンションにも使用されます）
- description: Skill をいつ呼び出すべきかを判断できるように、AI モデルに渡される簡潔な説明
有効な name の例: 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 フィールドが重要です。これは、その Skill をいつ呼び出すべきかを Cascade が理解する助けになります。Skill が何を行い、いつ使うべきかを明確に説明するように記述してください。
Cascade の入力欄で @skill-name と入力することで、いつでもスキルを明示的に起動できます。これは、特定のスキルを必ず使用させたい場合や、リクエストだけでは自動的にトリガーされない可能性のあるスキルを明示的に呼び出したい場合に便利です。
| スコープ | 場所 | 適用範囲 |
|---|
| ワークスペース | .windsurf/skills/ | 現在のワークスペースのみ。リポジトリと一緒にコミットされます。 |
| グローバル | ~/.codeium/windsurf/skills/ | このマシン上のすべてのワークスペース。コミットされません。 |
| システム (Enterprise) | OS固有 (以下を参照) | すべてのワークスペース。IT によって展開されます。読み取り専用です。 |
エージェント間の互換性のため、Windsurf は .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 よりも適切です。名前から、そのスキルが何をするのかが明確に伝わるようにしてください。
Skills vs Rules vs Workflows
| Skills | Rules | Workflows |
|---|
| Purpose | サポートファイルを伴う複数ステップの手順 | 振る舞いに関するガイドライン (“どう振る舞うか”) | 繰り返し可能なタスク向けのプロンプトテンプレート |
| Structure | SKILL.md と任意のリソースファイルを含むフォルダ | フロントマターを含む単一の .md ファイル | 単一の .md ファイル |
| Invocation | モデルが決定 (段階的開示) または @mention | always_on / glob / model_decision / manual | /slash-command による手動のみ |
| In system prompt? | いいえ — 呼び出されるまでは名前と説明のみ | 有効化モードによる | いいえ — 使用可能なコマンドとして一覧表示される |
| Best for | スクリプトやテンプレートが必要なデプロイ、コードレビュー、テスト手順 | コーディングスタイル、プロジェクトの規約、制約 | 明示的にトリガーする単発のランブック |
- Workflows - スラッシュコマンドで呼び出せる再利用可能な Markdown ワークフローを使って、繰り返し作業を自動化します
- AGENTS.md - ファイルの場所に基づいて自動的に適用される、ディレクトリ単位の指示を提供します
- Memories & Rules - 自動生成されるメモリとユーザー定義ルールにより、会話間のコンテキストを保持します
