> ## 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 に複数ステップのワークフローを一貫して実行する方法を教えるための優れた手段です。

Cascade は [**段階的開示**](https://agentskills.io/what-are-skills#how-skills-work) を採用しています。デフォルトでは、モデルに表示されるのはスキルの `name` と `description` だけです。完全な `SKILL.md` の内容と補助ファイルが読み込まれるのは、**Cascade がそのスキルを呼び出すと判断したとき** (または `@mention` したとき) だけです。これにより、多数のスキルを定義していても、前提情報のウィンドウをコンパクトに保てます。

スキル仕様の詳細については、[agentskills.io](https://agentskills.io/home) を参照してください。

<div id="how-to-create-a-skill">
  ## スキルの作成方法
</div>

<div id="using-the-ui-easiest">
  ### UI を使う方法 (最も簡単)
</div>

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

<div id="manual-creation">
  ### 手動作成
</div>

**Workspace Skill (プロジェクト固有) :**

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

**Global Skill (すべてのワークスペースで利用可能) :**

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

<div id="skillmd-file-format">
  ## SKILL.md ファイル形式
</div>

各スキルには、スキルのメタデータを含む YAML フロントマターを持つ `SKILL.md` ファイルが必要です:

<div id="example-skill">
  ### スキルの例
</div>

```markdown theme={null}
---
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]
```

<div id="required-frontmatter-fields">
  ### 必須のFrontmatterフィールド
</div>

* **name**: スキルの一意の識別子 (UIに表示され、@メンションでも使用されます)
* **description**: モデルがそのスキルをいつ呼び出すべきか判断できるように表示される、簡潔な説明

有効な名前の例: `deploy-to-staging`, `code-review`, `setup-dev-environment`

<div id="adding-supporting-resources">
  ## 補助リソースの追加
</div>

`SKILL.md` と同じ スキル フォルダに、必要な補助ファイルを配置します。これらのファイルは、スキル の呼び出し時に Cascade から利用できるようになります。

```
.windsurf/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
```

<div id="invoking-skills">
  ## スキルを呼び出す
</div>

<div id="automatic-invocation">
  ### 自動呼び出し
</div>

リクエストがスキルの説明に一致すると、Cascade は自動的にそのスキルを呼び出し、その指示とリソースを利用してタスクを完了します。これはスキルの最も一般的な利用方法です。やりたいことを説明するだけで、どのスキルが適切かを Cascade が判断します。

スキルの フロントマター にある `description` フィールドは重要です。このフィールドによって、Cascade はどのタイミングでそのスキルを呼び出すべきかを判断できます。説明文には、そのスキルで何ができるのか、どのような場合に利用すべきかが明確に伝わるように記述してください。

<div id="manual-invocation">
  ### 手動での呼び出し
</div>

Cascade の入力欄に `@skill-name` と入力すると、いつでも明示的にスキルを有効化できます。これは、特定のスキルを確実に利用したい場合や、リクエストでは自動的にトリガーされない可能性があるスキルを呼び出したい場合に便利です。

<div id="skill-scopes">
  ## スキルのスコープ
</div>

| スコープ              | 場所                            | 利用可能範囲                            |
| ----------------- | ----------------------------- | --------------------------------- |
| ワークスペース           | `.windsurf/skills/`           | 現在のワークスペースのみ。リポジトリと一緒にコミットされます。   |
| グローバル             | `~/.codeium/windsurf/skills/` | お使いのマシン上のすべてのワークスペース。コミットされません。   |
| システム (Enterprise) | OS によって異なります (以下を参照)          | すべてのワークスペース。IT によって配布されます。読み取り専用。 |

<Note>
  エージェント間の互換性のため、Devin Desktop は `.agents/skills/` と `~/.agents/skills/` 内のスキルも検出します。Claude Code の設定の読み取りを有効にしている場合は、`.claude/skills/` と `~/.claude/skills/` もスキャンされます。
</Note>

<div id="system-level-skills-enterprise">
  ### システムレベルのスキル (Enterprise)
</div>

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

| OS        | Path                                            |
| --------- | ----------------------------------------------- |
| macOS     | `/Library/Application Support/Windsurf/skills/` |
| Linux/WSL | `/etc/windsurf/skills/`                         |
| Windows   | `C:\ProgramData\Windsurf\skills\`               |

各スキルは、ワークスペースのスキルと同様に、`SKILL.md` ファイルを含むサブディレクトリになっています。

<div id="example-use-cases">
  ## 使用例
</div>

<div id="deployment-workflow">
  ### デプロイワークフロー
</div>

デプロイスクリプト、環境設定、ロールバック手順を含むスキルを作成します：

```
.windsurf/skills/deploy-staging/
├── SKILL.md
├── pre-deploy-checks.sh
├── environment-template.env
└── rollback-steps.md
```

<div id="code-review-guidelines">
  ### コードレビューのガイドライン
</div>

スタイルガイド、セキュリティチェックリスト、レビューテンプレートを含めます。

```
.windsurf/skills/code-review/
├── SKILL.md
├── style-guide.md
├── security-checklist.md
└── review-template.md
```

<div id="testing-procedures">
  ### テスト手順
</div>

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

```
.windsurf/skills/run-tests/
├── SKILL.md
├── test-template.py
├── coverage-config.json
└── ci-workflow.yaml
```

<div id="best-practices">
  ## ベストプラクティス
</div>

1. **明確な説明を書く**: 説明は、Cascade がそのスキルをいつ呼び出すべきかを判断するのに役立ちます。スキルの内容と、どのような場合に利用すべきかを具体的に記述してください。

2. **関連するリソースを含める**: テンプレート、チェックリスト、使用例があると、スキルはより便利になります。そのタスクを完了するうえで役立つファイルは何かを考えてください。

3. **わかりやすい名前を付ける**: `deploy-to-staging` は `deploy1` より適切です。名前を見れば、そのスキルが何をするものかがすぐにわかるようにしてください。

<div id="skills-vs-rules-vs-workflows">
  ## スキル vs ルール vs ワークフロー
</div>

いずれも Cascade をカスタマイズするものですが、**構造**、**呼び出し方法**、**前提情報コスト**が異なります。

|                 | スキル                                | ルール                                                | ワークフロー                      |
| --------------- | ---------------------------------- | -------------------------------------------------- | --------------------------- |
| **目的**          | 補助ファイルを伴う複数ステップの手順                 | 振る舞いのガイドライン (「どう振る舞うか」)                            | 繰り返し使うタスク向けのプロンプトテンプレート     |
| **構造**          | `SKILL.md` と任意のリソースファイルを含むフォルダー    | フロントマター を含む単一の `.md` ファイル                          | 単一の `.md` ファイル              |
| **呼び出し**        | モデルが決定 (段階的開示) または `@mention`      | `always_on` / `glob` / `model_decision` / `manual` | `/slash-command` での**手動のみ** |
| **システムプロンプト内?** | いいえ — 呼び出されるまでは名前と説明のみ             | 有効化モードによる                                          | いいえ — 利用可能なコマンドとして一覧表示される   |
| **最適な用途**       | スクリプトやテンプレートが必要なデプロイ、コードレビュー、テスト手順 | コーディングスタイル、プロジェクトの慣例、制約                            | 明示的にトリガーする単発のランブック          |

**目安:** Cascade が自動的に適用すべきもので、*かつ*補助ファイルが必要なら、スキルを利用します。短い振る舞いの制約であれば、ルールを利用します。常に自分でトリガーしたいなら、ワークフローを利用します。

<div id="related-documentation">
  ## 関連ドキュメント
</div>

Skills が目的でない場合は、以下の Cascade の他の機能をご覧ください。

* **[ワークフロー](./workflows)** - スラッシュコマンドで呼び出せる再利用可能な Markdown ワークフローを使って、反復的なタスクを自動化します
* **[AGENTS.md](./agents-md)** - ファイルの場所に応じて自動的に適用される、ディレクトリ単位の指示を与えます
* **[Memories & ルール](./memories)** - 自動生成される Memories とユーザー定義のルールによって、会話をまたいで前提情報を保持します