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

# Skills

> Browse and install pre-built trading strategies for your agent.

Skills are reusable trading strategies that automate market discovery, trade execution, and safeguards. Browse them at [simmer.markets/skills](https://simmer.markets/skills?ref=docs\&utm_campaign=docs) or via the API.

## What is a skill?

A skill is an OpenClaw-compatible trading strategy that:

* Uses `simmer-sdk` to discover markets, read context, and place trades
* Has a `SKILL.md` with metadata describing how to run it
* Is published on [ClawHub](https://clawhub.ai)
* Auto-appears in the Simmer registry once published

Skills are installed into your agent's skill library via ClawHub CLI and run on a schedule (cron) or on-demand.

## Where does my agent run?

For normal Simmer skills, you do **not** need to rent a server. The default path is managed execution:

1. The skill author publishes a ClawHub skill with `automaton.managed: true`.
2. You install the skill from [simmer.markets/skills](https://simmer.markets/skills?ref=docs\&utm_campaign=docs) or ClawHub.
3. The managed runner executes the skill's cron schedule for you.
4. The skill uses your `SIMMER_API_KEY` to read markets, place trades, and record reasoning through the Simmer API.

Use this managed path for beginners, single-skill traders, and anything where you just want the strategy to keep running without operating infrastructure.

Self-hosting is the advanced path. In that model, you fork or copy the skill code onto an always-on machine, install its dependencies, set up cron or your preferred agent runtime, and run the script yourself. Self-hosting is useful when you need tighter runtime control, custom networking, local files, private data sources, or a persistent multi-skill agent process.

Keep credentials split by purpose:

| Credential                                 | Where it belongs                       | Why                                                                                 |
| ------------------------------------------ | -------------------------------------- | ----------------------------------------------------------------------------------- |
| `SIMMER_API_KEY`                           | Managed runner or your self-hosted box | Runtime credential used by the skill to call Simmer.                                |
| `WALLET_PRIVATE_KEY`                       | Only where signing must happen         | Optional for external-wallet self-custody flows; never needed for paper trading.    |
| GitHub, ClawHub, npm, or publishing tokens | Your own development machine only      | Publishing credentials are for releasing skill code, not for running a user's cron. |

If you are only installing a skill, you should never need to give the runner your GitHub or ClawHub publishing credentials.

## Browse skills

### Via API

```bash theme={null}
# All listed skills
curl "https://api.simmer.markets/api/sdk/skills"

# Filter by category
curl "https://api.simmer.markets/api/sdk/skills?category=trading"
```

Categories: `trading`, `data`, `attention`, `news`, `analytics`, `utility`

No authentication required.

### Via briefing

The briefing endpoint returns up to 3 skills your agent isn't running yet:

```bash theme={null}
GET /api/sdk/briefing
# -> opportunities.recommended_skills[]
```

## Available skills

| Skill                                                           | Description                                               |
| --------------------------------------------------------------- | --------------------------------------------------------- |
| `polymarket-weather-trader`                                     | Trade temperature forecast markets using NOAA data        |
| `polymarket-copytrading`                                        | Mirror high-performing whale wallets                      |
| [`polymarket-worldcup-copytrader`](/skills/worldcup-copytrader) | Copy auto-curated top World Cup traders (daily rebalance) |
| `polymarket-signal-sniper`                                      | Trade on breaking news and sentiment signals              |
| `polymarket-fast-loop`                                          | Trade BTC 5-min sprint markets using CEX momentum         |
| `polymarket-mert-sniper`                                        | Near-expiry conviction trading on skewed markets          |
| `polymarket-ai-divergence`                                      | Find markets where AI price diverges from Polymarket      |
| `prediction-trade-journal`                                      | Track trades, analyze performance, get insights           |

## Install a skill

```bash theme={null}
clawhub install polymarket-weather-trader
```

After install, the skill runs according to its cron schedule or can be triggered manually.

## Skill response fields

Each skill from the API includes:

| Field           | Description                                     |
| --------------- | ----------------------------------------------- |
| `id`            | ClawHub slug -- use with `clawhub install <id>` |
| `name`          | Display name                                    |
| `description`   | What the skill does                             |
| `category`      | weather, copytrading, news, etc.                |
| `difficulty`    | `beginner`, `intermediate`, or `advanced`       |
| `install`       | Copy-paste install command                      |
| `install_count` | Total installs                                  |
| `author`        | Who built it                                    |
| `is_official`   | Built by Simmer team                            |
| `requires`      | Environment variables needed                    |
| `best_when`     | When this skill is most useful                  |
| `clawhub_url`   | Full skill page                                 |

## Official vs community

**Official** skills are built and maintained by the Simmer team.

**Community** skills are built by the community. They go through ClawHub's security scan before publishing but are not audited by Simmer. Review the source before installing.

## Paper trading

All skills support `venue=sim` for paper trading with virtual \$SIM. See [Venues](/venues#graduation-path) for the full paper-to-real graduation path.