> ## 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.

# Agent Skill

> Install the Snorbe Agent Skill for Claude Code / Cursor / Codex / Google Antigravity

# Agent Skill

We publish an Agent Skill that lets [Claude Code](https://claude.ai/code), Cursor, Codex, Google Antigravity, and any other [Agent Skills](https://skills.sh/)–compatible agent call the Snorbe API directly. The skill ships as a `SKILL.md`-compliant package, so every supported client can load it as-is.

## Installation

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

This installs the skill to `~/.claude/skills/snorbe-api/`. Restart your agent (Claude Code, Cursor, Codex, Google Antigravity, etc.) and the skill is auto-detected.

<Tip>
  To install only a specific skill, use `--skill`:

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

## What's in the skill

### `snorbe-api`

A skill for calling the Snorbe REST API, documented from these angles:

| File                 | Contents                                                                                         |
| -------------------- | ------------------------------------------------------------------------------------------------ |
| `SKILL.md`           | Authentication, base URL, capability summary, endpoint quick reference                           |
| `capabilities.md`    | 22 tools the agent can invoke, HITL artifacts, available models                                  |
| `prompting.md`       | How to write effective `inputText` and steer tool selection                                      |
| `runtime-gotchas.md` | SSE reception, timeouts, buffering, and other implementation pitfalls                            |
| `recipes/`           | Task-oriented workflows (basic research, patent claim batch extraction, graph exploration, etc.) |
| `reference/`         | Detailed API endpoint reference                                                                  |

## Authentication

After installing, set your API key as an environment variable:

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

Create an API key on the Snorbe dashboard **API Keys** page (shown once — keep it safe).

## Usage

Just ask your agent (Claude Code, Cursor, Codex, Google Antigravity, etc.) in natural language, and the skill takes over the API calls:

```
Use the Snorbe API to research "latest semiconductor trends" and save the result as JSON
```

```
Use the Snorbe API to get all claims for WO2012014047A1 from Google Patents
```

The skill handles endpoint selection, prompt design, SSE reception, error handling, and result parsing.

## Update and uninstall

```bash theme={null}
# Update
npx skills update

# List installed skills
npx skills list

# Uninstall
npx skills remove snorbe-api
```

## Source code

The skill source is public on GitHub. File issues or PRs:

<Card title="deskrexai/snorbe" icon="github" href="https://github.com/deskrexai/snorbe">
  Snorbe Agent Skills repository
</Card>

## See also

* [Execute Agent (non-streaming)](/en/api-reference/execute-agent)
* [Execute Agent (SSE streaming)](/en/api-reference/stream-agent-run)
* [Agent Workflows](/en/api-reference/agent-workflows)
* [List Turns](/en/api-reference/list-turns)