> ## 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 API を Claude Code / Cursor / Codex / Google Antigravity から呼び出す Agent Skill のインストール方法

# エージェントスキル (Agent Skill)

Snorbe API を [Claude Code](https://claude.ai/code)・Cursor・Codex・Google Antigravity など、[Agent Skills](https://skills.sh/) エコシステムに対応したエージェントから呼び出すためのスキルを公開しています。`SKILL.md` 準拠のパッケージとして配布しているため、対応クライアントであればどれでも同じスキルをそのまま読み込めます。

## インストール

```bash theme={null}
npx skills add deskrexai/snorbe
```

このコマンドで `~/.claude/skills/snorbe-api/` にスキルがインストールされます。Claude Code・Cursor・Codex・Google Antigravity など対応エージェントを再起動すれば自動認識されます。

<Tip>
  特定のスキルだけをインストールする場合は `--skill` オプションを指定:

  ```bash theme={null}
  npx skills add deskrexai/snorbe --skill snorbe-api
  ```
</Tip>

## スキルの内容

### `snorbe-api`

Snorbe REST API を呼び出すスキル。以下の観点でドキュメント化されています:

| ファイル                 | 内容                                   |
| -------------------- | ------------------------------------ |
| `SKILL.md`           | 認証・ベース URL・能力サマリ・エンドポイント早見表          |
| `capabilities.md`    | エージェントが持つ 22 ツール・HITL 生成物・使えるモデル     |
| `prompting.md`       | 効果的な `inputText` の書き方・ツール誘導方法        |
| `runtime-gotchas.md` | SSE 受信・タイムアウト・バッファリング等のハマりどころ        |
| `recipes/`           | タスク別ワークフロー（基本リサーチ・特許請求項一括抽出・グラフ探索など） |
| `reference/`         | API エンドポイントごとの詳細リファレンス               |

## 認証

スキルインストール後、API キーを環境変数に設定:

```bash theme={null}
export SNORBE_API_KEY=snorbe_xxxxxxxxxxxxxxxxxxxx
```

API キーは Snorbe ダッシュボードの **API Keys** ページで作成します（1 度だけ表示されるので安全に保管）。

## 使い方

対応エージェント (Claude Code・Cursor・Codex・Google Antigravity など) に次のように依頼するだけで、スキルが API 呼び出しを代行します:

```
Snorbe API で「最新の半導体トレンド」を調査して結果を JSON で保存して
```

```
Snorbe API で WO2012014047A1 の全請求項を Google Patents から取得して
```

スキル側がエンドポイント選択、プロンプト設計、SSE 受信、エラー処理、結果のパースなどをすべて面倒見ます。

## 更新とアンインストール

```bash theme={null}
# 更新
npx skills update

# 一覧
npx skills list

# アンインストール
npx skills remove snorbe-api
```

## ソースコード

スキルのソースは GitHub で公開しています。改善の提案や Issue はこちら:

<Card title="deskrexai/snorbe" icon="github" href="https://github.com/deskrexai/snorbe">
  Snorbe Agent Skills のリポジトリ
</Card>

## 関連

* [エージェント実行 (非ストリーミング)](/ja/api-reference/execute-agent)
* [エージェント実行 (SSE ストリーミング)](/ja/api-reference/stream-agent-run)
* [エージェント実行フロー](/ja/api-reference/agent-workflows)
* [ターン一覧取得](/ja/api-reference/list-turns)