> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snorbe.deskrex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# カスタムスキル

> Snorbeのカスタムスキル機能で独自の調査スキルを作成・管理する方法

# カスタムスキル

カスタムスキルは、Snorbeのエージェントに追加できる独自の調査手順や処理ロジックです。繰り返し行う調査や、特定のフォーマットで出力したい処理をスキルとして定義しておくと、チャットから呼び出すだけで実行できます。

一言でいうと、**「よく使う調査の型を、自分でプログラムして再利用できる」機能**です。

## できること

<CardGroup cols={2}>
  <Card title="スキルの作成" icon="plus">
    Markdownベースのフォーマットでスキルを定義。調査のステップ、使用するツール、出力フォーマットを記述します。
  </Card>

  <Card title="スキルの呼び出し" icon="bolt">
    チャットから定義したスキルを呼び出して実行。エージェントが手順通りに自動で調査を進めます。
  </Card>

  <Card title="公式スキル" icon="star">
    Snorbeが提供する公式スキルを利用可能にして、そのまま呼び出せます。よくあるユースケースのテンプレートとして活用できます。
  </Card>

  <Card title="スキルの管理" icon="folder">
    作成したスキルの一覧管理、編集、削除ができます。チーム内でスキルを共有して調査の標準化に活用できます。
  </Card>

  <Card title="スキルのフォーク" icon="code-branch">
    利用可能にした公式スキルを編集すると、自動的にフォーク（コピー）されて自分のスキルとして保存されます。フォークしたスキルは公式版より優先されます。
  </Card>

  <Card title="ZIPエクスポート/インポート" icon="file-zipper">
    スキルをZIPパッケージとしてエクスポート・インポートできます。チーム間やワークスペース間でのスキル共有に便利です。
  </Card>
</CardGroup>

## 使い方

### 1. スキルを作成する

カスタマイズ設定のスキル管理画面から新しいスキルを作成します。スキルはMarkdown形式で記述し、フロントマターにスキルのメタデータを定義します。

```markdown theme={null}
---
name: 競合調査スキル
description: 指定企業の競合分析を行うスキル
---

# 手順

1. 対象企業のWeb情報を収集する
2. 主要競合を3〜5社特定する
3. 技術・市場・価格の観点で比較表を作成する
4. 比較表としてエクスポートする
```

### 2. スキルを呼び出す

チャット画面でスキル名や関連するキーワードを入力すると、エージェントが適切なスキルを選択して実行します。

### 3. 結果を確認する

スキルの手順に沿ってエージェントが調査を実行し、定義したフォーマットで結果を出力します。

## 公式スキル

Snorbeには公式スキルが用意されています。利用可能にするだけで、そのまま呼び出して使えます。

<Note>
  公式スキルのソースコードは GitHub で公開しています。Claude Code / Cursor / Codex などの外部エージェントからも利用できます。

  <CardGroup cols={2}>
    <Card title="deskrexai/snorbe" icon="github" href="https://github.com/deskrexai/snorbe">
      スキル本体のソース。Issue・PR 歓迎
    </Card>

    <Card title="エージェントスキル" icon="terminal" href="/ja/api-reference/agent-skill">
      `npx skills add deskrexai/snorbe` で外部エージェントから呼び出し
    </Card>
  </CardGroup>
</Note>

### 論文・研究調査

<CardGroup cols={2}>
  <Card title="論文検索スキル（arXiv / PubMed / Semantic Scholar）" icon="book">
    学術DBから論文を横断検索。**multi-angle strategy・citation traversal・発行年やジャーナルでのフィルタ**に対応し、関連研究を網羅的に収集します。
  </Card>

  <Card title="統計調査スキル（e-Stat）" icon="chart-bar">
    政府統計データベースから市場規模・人口動態・経済指標などを取得します。
  </Card>
</CardGroup>

### 特許検索

<CardGroup cols={3}>
  <Card title="JPO（日本特許庁）" icon="scale-balanced">
    日本の特許・実用新案を検索。国内の先行事例調査に。
  </Card>

  <Card title="EPO OPS（欧州特許庁）" icon="scale-balanced">
    欧州・国際特許の書誌情報を取得。グローバルな出願状況の確認に。
  </Card>

  <Card title="Google Patents" icon="scale-balanced">
    全世界の特許を横断検索。幅広いカバレッジで傾向を俯瞰。
  </Card>
</CardGroup>

### 市場・投資データ

<CardGroup cols={3}>
  <Card title="CB Insights" icon="chart-line">
    スタートアップ・投資動向・市場マップの調査。
  </Card>

  <Card title="PitchBook" icon="briefcase">
    ベンチャーキャピタル・M\&A・企業評価データの取得。
  </Card>

  <Card title="Statista" icon="chart-bar">
    市場規模・統計データ・業界レポートの取得。
  </Card>
</CardGroup>

### 成果物生成

<CardGroup cols={2}>
  <Card title="Image Editing" icon="image">
    画像のクロップ・リサイズ・加工をエージェント内で実行。調査結果に添える画像を整えます。
  </Card>

  <Card title="Data Analysis and Visualization" icon="chart-simple">
    CSV などのデータを分析し、グラフを生成。レポート用の可視化を自動化します。
  </Card>
</CardGroup>

<Note>
  スキルが生成した HTML・SVG・画像などのビジュアル成果物は、チャット画面に **PNG プレビュー**として自動表示されます。生成ファイルはダウンロードも可能です。
</Note>

### ドキュメント処理

<CardGroup cols={2}>
  <Card title="PDF Toolkit" icon="file-pdf">
    PDFの読み取り、分割、結合、テキスト抽出。調査結果のPDF加工に。
  </Card>

  <Card title="DOCX Toolkit" icon="file-word">
    Wordドキュメントの読み取り、作成、編集。調査結果をWord形式のレポートに整形。
  </Card>

  <Card title="XLSX Toolkit" icon="file-excel">
    Excelスプレッドシート・CSVの読み取り、加工、チャート生成。数値データの集計・可視化に。
  </Card>

  <Card title="PPTX Toolkit" icon="file-powerpoint">
    PowerPointスライドの読み取り、作成、編集。調査結果をスライドにまとめたいときに。
  </Card>
</CardGroup>

### ブラウザ操作

<CardGroup cols={1}>
  <Card title="Browser Harness" icon="globe">
    ブラウザ操作系のスキルを実行します。特定サイトからの定型的なデータ取得や、ログインが必要なページの操作を自動化します。ブラウジング中のスクリーンショットがタイムラインに表示されます。
  </Card>
</CardGroup>

### スキルごとのモデル指定

カスタムスキルの `SKILL.md` フロントマターに `model` を指定すると、そのスキル実行時に使うモデルを個別に上書きできます。精度を優先したい専門スキルに、Claude Opus 4.7 などの高精度モデルを固定割り当てするような使い方が可能です。

```markdown theme={null}
---
name: 競合調査スキル
description: 指定企業の競合分析を行うスキル
model: claude-opus-4-7
---
```

## エージェント別のスキル設定

スキルはエージェントごとに有効・無効を設定できます。

* **エージェント編集画面**から、そのエージェントで使うスキルを個別に選択
* **エージェント作成時**にも、使用するスキルを選択可能
* **スキル管理画面**から、スキルの一括有効化・一括無効化が可能
* スキル管理画面で、どのエージェントが各スキルを使っているかを確認できる

## スキルのコンテキスト

スキル実行時に、会話履歴と直近のツール実行結果がサンドボックス内にMarkdownファイルとして自動書き込みされます。スキルのコードからこれらの情報を参照することで、会話の文脈を踏まえた処理が可能です。

スキル作成時にファイルを添付すると、そのファイルもサンドボックスに転送されます。

## よくあるユースケース

<CardGroup cols={3}>
  <Card title="定型調査の自動化" icon="rotate">
    毎週行う競合調査や市場レポートをスキルとして定義して、繰り返し実行を効率化。
  </Card>

  <Card title="出力フォーマットの統一" icon="file-lines">
    報告書や上申資料の形式をスキルで固定し、チーム全体でフォーマットを統一。
  </Card>

  <Card title="専門ドメイン調査" icon="flask">
    製薬、素材、法規制など専門性の高いドメイン特有の調査手順をスキルとして蓄積。
  </Card>
</CardGroup>

***

<Note>
  カスタムスキルはMarkdownで記述します。スキル内で使用できるツールは、エージェントが通常使用できるすべてのツール（Web検索、専門DB、ブラウジングなど）です。
</Note>
