メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

スキルの作成方法

UI を使う方法 (最も簡単)

  1. Cascade パネルを開きます
  2. パネル右上の三点アイコンをクリックして、カスタマイズメニューを開きます
  3. Skills セクションをクリックします
  4. + Workspace をクリックして workspace (プロジェクト固有) のスキルを作成するか、+ Global をクリックしてグローバルスキルを作成します
  5. スキルに名前を付けます (使用できるのは小文字、数字、ハイフンのみです)

手動作成

Workspace Skill (プロジェクト固有) :
  1. ディレクトリを作成します: .windsurf/skills/<skill-name>/
  2. YAMLフロントマター付きの SKILL.md ファイルを追加します
Global Skill (すべてのワークスペースで利用可能) :
  1. ディレクトリを作成します: ~/.codeium/windsurf/skills/<skill-name>/
  2. 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: スキルの一意の識別子 (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

スキルを呼び出す

自動呼び出し

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

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

Enterprise 組織では、すべてのワークスペースで利用でき、エンドユーザーが変更できないスキルをデプロイできます。
OSPath
macOS/Library/Application Support/Windsurf/skills/
Linux/WSL/etc/windsurf/skills/
WindowsC:\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

ベストプラクティス

  1. 明確な説明を書く: 説明は、Cascade がそのスキルをいつ呼び出すべきかを判断するのに役立ちます。スキルの内容と、どのような場合に利用すべきかを具体的に記述してください。
  2. 関連するリソースを含める: テンプレート、チェックリスト、使用例があると、スキルはより便利になります。そのタスクを完了するうえで役立つファイルは何かを考えてください。
  3. わかりやすい名前を付ける: deploy-to-stagingdeploy1 より適切です。名前を見れば、そのスキルが何をするものかがすぐにわかるようにしてください。

スキル vs ルール vs ワークフロー

いずれも Cascade をカスタマイズするものですが、構造呼び出し方法前提情報コストが異なります。
スキルルールワークフロー
目的補助ファイルを伴う複数ステップの手順振る舞いのガイドライン (「どう振る舞うか」)繰り返し使うタスク向けのプロンプトテンプレート
構造SKILL.md と任意のリソースファイルを含むフォルダーフロントマター を含む単一の .md ファイル単一の .md ファイル
呼び出しモデルが決定 (段階的開示) または @mentionalways_on / glob / model_decision / manual/slash-command での手動のみ
システムプロンプト内?いいえ — 呼び出されるまでは名前と説明のみ有効化モードによるいいえ — 利用可能なコマンドとして一覧表示される
最適な用途スクリプトやテンプレートが必要なデプロイ、コードレビュー、テスト手順コーディングスタイル、プロジェクトの慣例、制約明示的にトリガーする単発のランブック
目安: Cascade が自動的に適用すべきもので、かつ補助ファイルが必要なら、スキルを利用します。短い振る舞いの制約であれば、ルールを利用します。常に自分でトリガーしたいなら、ワークフローを利用します。 Skills が目的でない場合は、以下の Cascade の他の機能をご覧ください。
  • ワークフロー - スラッシュコマンドで呼び出せる再利用可能な Markdown ワークフローを使って、反復的なタスクを自動化します
  • AGENTS.md - ファイルの場所に応じて自動的に適用される、ディレクトリ単位の指示を与えます
  • Memories & ルール - 自動生成される Memories とユーザー定義のルールによって、会話をまたいで前提情報を保持します