Cascade Skills

最も難しいエンジニアリングタスクでは、優れたプロンプトだけでは足りないことがよくあります。参照用スクリプト、テンプレート、チェックリスト、その他のサポートファイルが必要になることもあります。スキルを使うと、これらをすべてフォルダにまとめて、Cascade が呼び出せる (読み取って利用できる) ようにできます。スキルは、Cascade に複数ステップのワークフローを一貫して実行する方法を教えるための優れた手段です。 Cascade は 段階的開示 を使用します。デフォルトでは、モデルに表示されるのはスキルの name と description のみです。SKILL.md の完全な内容とサポートファイルが読み込まれるのは、Cascade がそのスキルを呼び出すと判断したとき (または @mention したとき) だけです。これにより、多数のスキルを定義していてもコンテキストウィンドウをスリムに保てます。 Skills の仕様の詳細については、agentskills.io を参照してください。

スキルの作成方法

UI を使う方法（最も簡単）

Cascade パネルを開きます
パネル右上の三点アイコンをクリックして、Customizations メニューを開きます
Skills セクションをクリックします
+ Workspace をクリックしてプロジェクト固有のワークスペーススキルを作成するか、+ Global をクリックしてグローバルスキルを作成します
スキルに名前を付けます（小文字のアルファベット、数字、ハイフンのみ使用可能）

手動作成

ワークスペーススキル（プロジェクト固有）:

ディレクトリを作成します: .windsurf/skills/<skill-name>/
YAML フロントマターを含む SKILL.md ファイルを追加します

グローバルスキル（すべてのワークスペースで利用可能）:

ディレクトリを作成します: ~/.codeium/windsurf/skills/<skill-name>/
YAML フロントマターを含む SKILL.md ファイルを追加します

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]

必須の Frontmatter フィールド

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

スキルの呼び出し

自動呼び出し

リクエストがいずれかの Skill の説明に合致すると、Cascade はその Skill を自動的に呼び出し、その指示とリソースを使ってタスクを完了します。これは Skill の最も一般的な使われ方です。やりたいことを説明するだけで、Cascade がどの Skill が関連するかを判断してくれます。 Skill のフロントマター内の 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/ もスキャンされます。

システムレベルのスキル (Enterprise)

Enterprise 組織では、すべてのワークスペースで利用でき、エンドユーザーは変更できないスキルを展開できます。

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

テスト手順

テストテンプレート、カバレッジ要件、CI/CD 設定をひとまとめにする：

.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

これらはすべて Cascade をカスタマイズしますが、構造、呼び出し方法、コンテキストコスト が異なります。

	Skills	Rules	Workflows
Purpose	サポートファイルを伴う複数ステップの手順	振る舞いに関するガイドライン (“どう振る舞うか”)	繰り返し可能なタスク向けのプロンプトテンプレート
Structure	`SKILL.md` と任意のリソースファイルを含むフォルダ	フロントマターを含む単一の `.md` ファイル	単一の `.md` ファイル
Invocation	モデルが決定 (段階的開示) または `@mention`	`always_on` / `glob` / `model_decision` / `manual`	`/slash-command` による手動のみ
In system prompt?	いいえ — 呼び出されるまでは名前と説明のみ	有効化モードによる	いいえ — 使用可能なコマンドとして一覧表示される
Best for	スクリプトやテンプレートが必要なデプロイ、コードレビュー、テスト手順	コーディングスタイル、プロジェクトの規約、制約	明示的にトリガーする単発のランブック

Rule of thumb: Cascade に自動的に拾ってほしく、なおかつ サポートファイルが必要ならスキルを使います。短い振る舞い上の制約なら Rule を使います。常に自分でトリガーしたいなら Workflow を使います。 Skills がお探しの機能と異なる場合は、他の Cascade 機能もご確認ください:

Workflows - スラッシュコマンドで呼び出せる再利用可能な Markdown ワークフローを使って、繰り返し作業を自動化します
AGENTS.md - ファイルの場所に基づいて自動的に適用される、ディレクトリ単位の指示を提供します
Memories & Rules - 自動生成されるメモリとユーザー定義ルールにより、会話間のコンテキストを保持します

エディタ

Cascade

アカウント

コンテキスト対応

トラブルシューティング

セキュリティ

Skills

スキルの作成方法

UI を使う方法（最も簡単）

手動作成

SKILL.md ファイル形式

サンプルスキル

必須の Frontmatter フィールド

サポートリソースの追加

スキルの呼び出し

自動呼び出し

手動呼び出し

スキルのスコープ

システムレベルのスキル (Enterprise)

利用例

デプロイワークフロー

コードレビューガイドライン

テスト手順

ベストプラクティス

Skills vs Rules vs Workflows

​スキルの作成方法

​UI を使う方法（最も簡単）

​手動作成

​SKILL.md ファイル形式

​サンプルスキル

​必須の Frontmatter フィールド

​サポートリソースの追加

​スキルの呼び出し

​自動呼び出し

​手動呼び出し

​スキルのスコープ

​システムレベルのスキル (Enterprise)

​利用例

​デプロイワークフロー

​コードレビューガイドライン

​テスト手順

​ベストプラクティス

​Skills vs Rules vs Workflows

​関連ドキュメント

スキルの作成方法

UI を使う方法（最も簡単）

手動作成

SKILL.md ファイル形式

サンプルスキル

必須の Frontmatter フィールド

サポートリソースの追加

スキルの呼び出し

自動呼び出し

手動呼び出し

スキルのスコープ

システムレベルのスキル (Enterprise)

利用例

デプロイワークフロー

コードレビューガイドライン

テスト手順

ベストプラクティス

Skills vs Rules vs Workflows

関連ドキュメント