# Skills (/ja/docs/verdent-manager/core-features/skills)
> 再利用可能なナレッジパックで Verdent の機能を拡張し、専門的なワークフローやドメイン知識に対応します
Verdent の **Skills** は、エージェントの専門知識を拡張する再利用可能なナレッジパックです。各 Skill には、ドメイン固有のプロンプト、スクリプト、リファレンス、ベストプラクティスが含まれています。名前で Skill を呼び出すだけで、エージェントが対応するコンテキストを読み込み、あらかじめ定義されたワークフローに従います。
***
## Skills とは [#skills-とは]
### 基本概念 [#基本概念]
**Skill** は、フォルダーに格納された構造化されたナレッジパックです。各 Skill には、名前、説明、詳細なプロンプトを定義する `SKILL.md` ファイルが含まれています。会話で Skill を呼び出すと、Verdent がこのファイルを読み込み、その内容をエージェントのコンテキストに注入します。
### Skills とサブエージェント、MCP の違い [#skills-とサブエージェントmcp-の違い]
| 観点 | Skills | サブエージェント | MCP |
| ----------- | -------------------------- | ----------------------- | ----------------------------- |
| **トリガー** | `@skill` またはメンションによる手動呼び出し | メインエージェントによる自動生成 | 自動呼び出しまたは明示的な呼び出し |
| **実行** | メイン会話のコンテキストを拡張 | 独立したコンテキストを持つサブタスクとして実行 | JSON-RPC 2.0 経由で外部ツールを呼び出す |
| **目的** | ドメインガイダンス（例:「テストの書き方」） | 独立した操作（例:「コードレビューの実行」） | 外部データ/ツールへのアクセス（例: データベースクエリ） |
| **ライフサイクル** | 一度きりのコンテキスト注入 | サブタスク完了後に結果を返す | セッション中は常駐するサーバープロセス |
| **実装** | Markdown ファイル + 任意のスクリプト | エージェントの組み込みロジック | 実行可能なサーバープロセス |
要するに、**Skills は知識とワークフローのガイダンスを提供し**、**サブエージェントは独立したタスクを実行し**、**MCP は外部ツールやデータソースに接続します**。
***
## Skills の使い方 [#skills-の使い方]
### Skill の呼び出し [#skill-の呼び出し]
Skill は 2 つの方法で呼び出せます。
**1. 会話で Skill 名をメンションする**
```
Use the skill-creator skill to help me create a new Skill
```
**2. @ メンション構文を使う**
```
@skill-creator help me create a Skill for API documentation generation
```
Skill がトリガーされると、次のように動作します。
1. エージェントが `skill` ツールを呼び出し、Skill の `SKILL.md` ファイルを読み込みます
2. ファイルの内容が現在の会話コンテキストに注入されます
3. エージェントは Skill のガイダンスに従って作業を続けます
### 利用可能な Skills の閲覧 [#利用可能な-skills-の閲覧]
設定から Skills パネルにアクセスします。
1. **Settings** メニューを開きます
2. **Skills** タブを選択します
3. インストール済みの Skills と、Skill Store で利用可能な Skills を閲覧します
入力ボックスに `@` と入力すると、オートコンプリートがトリガーされ、利用可能な Skill をすばやく選択できます。
***
## 組み込み Skills [#組み込み-skills]
Verdent には、一般的なワークフローをカバーする組み込み Skills のセットが付属しています。
| Skill | 説明 |
| ------------------- | --------------------------------------------------------- |
| **docx** | Word 文書（`.docx`）を読み取り、作成、編集し、書式に忠実な視覚的チェックを行います |
| **find-skills** | Skills を発見してインストールします。「X はどうやるのか?」と尋ねるときや、新しい機能を探すときに使います |
| **frontend-design** | 高い設計品質で、特徴的なプロダクション品質のフロントエンドインターフェースを作成します |
| **pdf** | PDF ファイルを視覚的なレンダリングとコンテンツ抽出により読み取り、作成、レビューします |
| **pptx** | PowerPoint プレゼンテーション（`.pptx`）を読み取り、作成、編集します |
| **skill-creator** | カスタム Skills を作成・反復するためのガイド付きワークフローです |
| **xlsx** | Excel スプレッドシートを読み取り、分析、可視化、スマート編集します |
さらに多くの Skills が **Skill Store** で利用できます。**Settings → Skills → Store** を開いて、追加の Skills を閲覧してインストールできます。
***
## カスタム Skills の作成 [#カスタム-skills-の作成]
カスタム Skills を作成して、チームのドメイン知識やプロジェクト固有のワークフローをカプセル化できます。
### Skill ディレクトリ構造 [#skill-ディレクトリ構造]
標準的な Skill フォルダーは次のようになります。
```
my-custom-skill/
├── SKILL.md # Required: Skill definition file
├── agents/
│ └── verdent.yaml # Optional: UI configuration (icons, display name)
├── scripts/ # Optional: helper scripts
└── references/ # Optional: reference docs or examples
```
### SKILL.md の形式 [#skillmd-の形式]
`SKILL.md` は Skill の中核となるファイルで、YAML フロントマターと Markdown 本文を含みます。
```markdown
---
name: my-custom-skill
description: A concise description shown in the Skill list
metadata:
version: "1.0.0"
author: "Your Name"
license: "MIT"
---
# Detailed Instructions
This is the detailed prompt content the Agent reads.
## Workflow
1. Step one
2. Step two
3. ...
## Best Practices
- Practice suggestion 1
- Practice suggestion 2
```
**フロントマターのフィールド要件:**
* `name`（必須）: フォルダー名と一致する必要があります。使用できるのは小文字、数字、ハイフン（`a-z0-9-`）のみです。長さは 1〜64 文字。連続するハイフンや、先頭・末尾のハイフンは使えません。
* `description`（必須）: 短い説明。最大 1024 文字です。
* `metadata`（任意）: バージョン、作者、ライセンスなどのメタ情報です。
### カスタム Skills のインストール [#カスタム-skills-のインストール]
**方法 1: 設定からインポート**
1. **Settings → Skills** を開きます
2. **Import Skill** を選択します
3. Skill フォルダー（または `.zip` / `.skill` アーカイブ）を選択します
4. Verdent が `SKILL.md` を検証し、`~/.verdent/skills/` にインストールします
**方法 2: 手動コピー**
```bash
cp -r my-custom-skill ~/.verdent/skills/
```
Verdent を再起動するか Skills 一覧を更新すると、Skill が利用可能になります。
**方法 3: プロジェクトレベルの Skill**
Skill をプロジェクトディレクトリ内に配置します。
```bash
cp -r my-custom-skill /path/to/your/project/.verdent/skills/
```
プロジェクトレベルの Skill はそのプロジェクト内でのみ表示され、同名のグローバル Skill よりも優先されます。
***
## Skill のスコープ [#skill-のスコープ]
Verdent は 3 段階の Skill スコープをサポートしています。
| レベル | 場所 | 表示範囲 |
| ---------- | ---------------------------- | ------------------- |
| **グローバル** | `~/.verdent/skills/` | すべてのプロジェクトとワークスペース |
| **プロジェクト** | `/.verdent/skills/` | 現在のプロジェクトのワークスペースのみ |
**優先ルール:**
同名の Skill が複数のスコープに存在する場合:
* プロジェクトがグローバルを上書きします
***
## Skill Store [#skill-store]
Verdent には、コミュニティおよび公式の Skills を閲覧・インストールできる **Skill Store** があります。
### Skill Store の閲覧 [#skill-store-の閲覧]
1. **Settings → Skills** を開きます
2. **Store** タブに切り替えます
3. 利用可能な Skills を閲覧するか、検索ボックスを使います
### Store からのインストール [#store-からのインストール]
1. Store で目的の Skill を探します
2. **Install** を選択します
3. Skill が自動的にダウンロードされ、`~/.verdent/skills/` にインストールされます
**セキュリティ検証:**
Store からインストールした Skills は、ファイルの整合性とセキュリティを確保するため SHA256 チェックサムによる検証が行われます。
***
## 実践例 [#実践例]
### 例 1: `skill-creator` で新しい Skill を作成する [#例-1-skill-creator-で新しい-skill-を作成する]
```
@skill-creator help me create a Skill for guiding the team on writing Go unit tests
```
エージェントは次のように動作します。
1. `skill-creator` Skill の内容を読み込みます
2. Skill の名前、説明、コアプロンプトの入力をガイドします
3. 標準的な `SKILL.md` を生成します
4. インストールパスと検証手順を提案します
### 例 2: `spreadsheet` でデータを分析する [#例-2-spreadsheet-でデータを分析する]
```
@spreadsheet read sales-2025.xlsx from the project root, analyze Q1 sales trends, and generate a chart
```
エージェントは次のように動作します。
1. `spreadsheet` Skill を読み込みます
2. `pandas` と `openpyxl` を使って Excel ファイルを読み取ります
3. データを分析し、可視化を生成します
4. 結果を保存するか、会話内に表示します
### 例 3: `gh-fix-ci` で CI を修正する [#例-3-gh-fix-ci-で-ci-を修正する]
```
@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug
```
エージェントは次のように動作します。
1. `gh` CLI を使って PR #123 の CI ログを取得します
2. 失敗の原因（テストケースのエラー、依存関係の問題など）を分析します
3. 修正案を提示します
4. あなたの承認を得て、コードを修正し、修正をプッシュします
***
## よくある質問 [#よくある質問]
Skill を呼び出すと、エージェントが `SKILL.md` ファイルを読み込み、これがトークン使用量にカウントされるため、クレジットを消費します。ただし、Skill 自体が追加の API 呼び出しを行うことはありません。
はい。Skill を `~/.verdent/skills/`（グローバルスコープ）にインストールすると、すべてのプロジェクトで利用できます。
**Settings → Skills** で、Skill を右クリックして **Delete** を選択します。`undeletable` とマークされた組み込み Skills は削除できず、次回起動時に再インストールされます。
はい。Verdent は `~/.cursor/skills`、`~/.claude/skills`、`~/.codex/skills` にある Skills を自動的に検出し、インポートを促します。**Settings → Skills** で **Import from External Sources** を選択してください。
* **Project Rule**: 常に有効で、すべての会話に自動的に注入される指示
* **Skill**: 呼び出されたときだけ注入される、オンデマンドのナレッジパック
汎用的なコーディング規約には Rules を、特定のドメインワークフローには Skills を使ってください。
Skill Store からインストールした Skills は、バックグラウンドで自動的に更新が確認されます。手動でインストールした Skills を更新するには、再インポート（古いバージョンを上書き）する必要があります。
***
## 高度な使い方 [#高度な使い方]
### Skills へのスクリプトの埋め込み [#skills-へのスクリプトの埋め込み]
Skill に `scripts/` ディレクトリを追加し、`SKILL.md` でスクリプトを参照します。
```markdown
## Data Processing Script
Run the following command to process data:
\`\`\`bash
python scripts/process_data.py --input data.csv --output results.json
\`\`\`
```
エージェントはこの指示を読み取り、必要に応じてスクリプトを実行します。
### ドキュメントの参照 [#ドキュメントの参照]
API のドキュメント、仕様、サンプルコードを `references/` ディレクトリに格納し、`SKILL.md` でリンクします。
```markdown
## Reference Documentation
See [references/api-spec.md](references/api-spec.md) for the detailed API specification.
```
エージェントは Skill の指示に基づいて、これらの参照ファイルを読み取れます。
***
## ベストプラクティス [#ベストプラクティス]
**Skills は焦点を絞る。** 各 Skill は単一のドメインやワークフローを対象にすべきです。「何でもこなす」Skills を作るのは避け、より小さく専門化したものに分割してください。
**わかりやすい名前を付ける。** Skill 名は簡潔でわかりやすくします。例えば `my-skill-1` ではなく `api-doc-generator` のようにします。
**例とリファレンスを提供する。** `SKILL.md` に具体的な例と参照リンクを含めると、エージェントが期待される出力をより理解しやすくなります。
**バージョン番号を管理する。** `metadata.version` フィールドを使って更新と互換性を追跡します。
**共有前にテストする。** チームに展開したり Skill Store に公開したりする前に、テストプロジェクトで Skill を検証してください。
***
## 関連項目 [#関連項目]
サブエージェントの仕組みと管理方法
MCP 経由で外部ツールやサービスを接続する
常に有効な Project Rules と User Rules を設定する
組み込みの Reviewer でコードの変更をレビューする