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

# Agent Skills

> Teach Claude Code, Cursor, Codex, and 70+ other coding agents how to use OneShot via skills.sh

## What are Agent Skills?

[Agent Skills](https://skills.sh) are reusable `SKILL.md` instruction files that any of 70+ coding
agents can install on demand. OneShot publishes a set of skills that teach your agent how to use
the OneShot SDK and MCP tools — email, voice, research, enrichment, commerce, browser automation,
website builds, and autonomous compute goals — all settled in USDC via x402.

<Info>
  Skills are installed with the [`skills` CLI](https://github.com/vercel-labs/skills) and work in
  Claude Code, Cursor, Codex, Cline, and [many more](https://github.com/vercel-labs/skills#supported-agents).
</Info>

## Installation

```bash theme={null}
# Install all OneShot skills
npx skills add oneshot-agent/agent-skills

# Or install just what you need
npx skills add oneshot-agent/agent-skills --skill oneshot --skill oneshot-email

# List everything available
npx skills add oneshot-agent/agent-skills --list
```

Start with the **`oneshot`** skill — it covers install, wallet/auth (Coinbase CDP or raw key),
funding, and the shared options every paid tool accepts. Then add the capability skills you need.

## Available Skills

| Skill                | What it does                                                                     |
| -------------------- | -------------------------------------------------------------------------------- |
| `oneshot`            | **Start here.** Setup, auth, funding, the x402 model, shared options, MCP config |
| `oneshot-email`      | Send/receive email, attachments, reply threading, sending-domain pool & warmup   |
| `oneshot-messaging`  | SMS send/inbox and autonomous AI voice calls                                     |
| `oneshot-research`   | Deep cited research, web search, read-a-URL-as-markdown                          |
| `oneshot-enrichment` | People search, profile enrichment, find/verify email, deep person intelligence   |
| `oneshot-commerce`   | Product search and autonomous purchase                                           |
| `oneshot-browser`    | Autonomous browser tasks + persistent logged-in profiles                         |
| `oneshot-build`      | Generate & deploy websites, then update them                                     |
| `oneshot-compute`    | Multi-step autonomous goals with a budget + spend analytics                      |
| `soul-markets`       | Monetize an agent: list a soul, sell/buy services, earn USDC                     |

## Use a skill without installing

You can pipe a skill's prompt straight into a supported agent:

```bash theme={null}
npx skills use oneshot-agent/agent-skills@oneshot | claude
```

## How it works

Each skill is a `SKILL.md` file — YAML frontmatter (`name` + `description`) plus instructions your
agent reads on demand. They document the [`@oneshot-agent/sdk`](/sdk/overview) (TypeScript) and
[`@oneshot-agent/mcp-server`](/sdk/mcp), so once a skill is installed your agent knows the exact
methods, parameters, and payment flow without you pasting docs into the prompt.

## Links

<CardGroup cols={2}>
  <Card title="Skills on skills.sh" icon="wand-magic-sparkles" href="https://skills.sh/oneshot-agent/agent-skills">
    Browse and install the OneShot skills
  </Card>

  <Card title="GitHub repo" icon="github" href="https://github.com/oneshot-agent/agent-skills">
    Source for all OneShot SKILL.md files
  </Card>

  <Card title="MCP Server" icon="plug" href="/sdk/mcp">
    The underlying tools the skills drive
  </Card>

  <Card title="SDK Overview" icon="box" href="/sdk/overview">
    Methods, auth, and the x402 payment model
  </Card>
</CardGroup>
