Skills

Verdent の Skills は、エージェントの専門知識を拡張する再利用可能なナレッジパックです。各 Skill には、ドメイン固有のプロンプト、スクリプト、リファレンス、ベストプラクティスが含まれています。名前で Skill を呼び出すだけで、エージェントが対応するコンテキストを読み込み、あらかじめ定義されたワークフローに従います。

Skills とは

基本概念

Skill は、フォルダーに格納された構造化されたナレッジパックです。各 Skill には、名前、説明、詳細なプロンプトを定義する SKILL.md ファイルが含まれています。会話で Skill を呼び出すと、Verdent がこのファイルを読み込み、その内容をエージェントのコンテキストに注入します。

Skills とサブエージェント、MCP の違い

要するに、Skills は知識とワークフローのガイダンスを提供し、サブエージェントは独立したタスクを実行し、MCP は外部ツールやデータソースに接続します。

Skills の使い方

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 パネルにアクセスします。

1. Settings メニューを開きます
2. Skills タブを選択します
3. インストール済みの Skills と、Skill Store で利用可能な Skills を閲覧します

入力ボックスに @ と入力すると、オートコンプリートがトリガーされ、利用可能な Skill をすばやく選択できます。

組み込み Skills

Verdent には、一般的なワークフローをカバーする組み込み Skills のセットが付属しています。

カスタム Skills の作成

カスタム Skills を作成して、チームのドメイン知識やプロジェクト固有のワークフローをカプセル化できます。

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 の形式

SKILL.md は Skill の中核となるファイルで、YAML フロントマターと 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 のインストール

方法 1: 設定からインポート

1. Settings → Skills を開きます
2. Import Skill を選択します
3. Skill フォルダー（または .zip / .skill アーカイブ）を選択します
4. Verdent が SKILL.md を検証し、~/.verdent/skills/ にインストールします

方法 2: 手動コピー

cp -r my-custom-skill ~/.verdent/skills/

Verdent を再起動するか Skills 一覧を更新すると、Skill が利用可能になります。

方法 3: プロジェクトレベルの Skill

Skill をプロジェクトディレクトリ内に配置します。

cp -r my-custom-skill /path/to/your/project/.verdent/skills/

プロジェクトレベルの Skill はそのプロジェクト内でのみ表示され、同名のグローバル Skill よりも優先されます。

Skill のスコープ

Verdent は 3 段階の Skill スコープをサポートしています。

優先ルール:

同名の Skill が複数のスコープに存在する場合:

• プロジェクトがグローバルを上書きします

Skill Store

Verdent には、コミュニティおよび公式の Skills を閲覧・インストールできる Skill Store があります。

Skill Store の閲覧

1. Settings → Skills を開きます
2. Store タブに切り替えます
3. 利用可能な Skills を閲覧するか、検索ボックスを使います

Store からのインストール

1. Store で目的の Skill を探します
2. Install を選択します
3. Skill が自動的にダウンロードされ、~/.verdent/skills/ にインストールされます

セキュリティ検証:

Store からインストールした Skills は、ファイルの整合性とセキュリティを確保するため SHA256 チェックサムによる検証が行われます。

実践例

例 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 でデータを分析する

@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 を修正する

@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug

エージェントは次のように動作します。

1. gh CLI を使って PR #123 の CI ログを取得します
2. 失敗の原因（テストケースのエラー、依存関係の問題など）を分析します
3. 修正案を提示します
4. あなたの承認を得て、コードを修正し、修正をプッシュします

よくある質問

高度な使い方

Skills へのスクリプトの埋め込み

Skill に scripts/ ディレクトリを追加し、SKILL.md でスクリプトを参照します。

## 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 でリンクします。

## Reference Documentation

See [references/api-spec.md](references/api-spec.md) for the detailed API specification.

エージェントは Skill の指示に基づいて、これらの参照ファイルを読み取れます。

ベストプラクティス

関連項目