--- name: simmer-skill-builder description: Generate complete, installable OpenClaw trading skills from natural language strategy descriptions. Use when your human wants to create a new trading strategy, build a bot, generate a skill, automate a trade idea, turn a tweet into a strategy, or asks "build me a skill that...". Produces a full skill folder (SKILL.md + Python script + config) ready to install and run. metadata: author: Simmer (@simmer_markets) version: "1.1.0" displayName: Simmer Skill Builder difficulty: beginner ---

Simmer Skill Builder

Generate complete, runnable Simmer trading skills from a strategy description.

> You are building an OpenClaw skill that trades prediction markets through the Simmer SDK. The skill you generate will be installed into your skill library and run by you — it must be a complete, self-contained folder that works out of the box.

Workflow

Step 1: Understand the Strategy

Ask your human what their strategy does. They might:

• Describe a trading thesis in plain language
• Paste a tweet or thread about a strategy
• Reference an external data source (Synth, NOAA, Binance, RSS, etc.)
• Say something like "build me a bot that buys weather markets" or "create a skill for crypto momentum"

Clarify until you understand:

1. Signal — What data drives the decision? (external API, market price, on-chain data, timing, etc.)
2. Entry logic — When to buy? (price threshold, signal divergence, timing window, etc.)
3. Exit logic — When to sell? (take profit threshold, time-based, signal reversal, or rely on auto-risk monitors)
4. Market selection — Which markets? (by tag, keyword, category, or discovery logic)
5. Position sizing — Fixed amount or smart sizing? What default max per trade?

Step 2: Load References

Read these files to understand the patterns:

1. references/skill-template.md — The canonical skill skeleton. Copy the boilerplate blocks verbatim (config system, get_client, safeguards, execute_trade, CLI args).
2. references/simmer-api.md — Simmer SDK API surface. All available methods, field names, return types.

If the Simmer MCP server is available (simmer://docs/skill-reference resource), prefer reading that for the most up-to-date API docs. Otherwise use references/simmer-api.md.

For real examples of working skills, read:

• references/example-weather-trader.md — Pattern: external API signal + Simmer SDK trading
• references/example-mert-sniper.md — Pattern: Simmer API only, filter-and-trade

Step 3: Get External API Docs (If Needed)

If the strategy uses an external data source:

• Polymarket CLOB data: If the Polymarket MCP server is available, search it for relevant endpoints (orderbook, prices, spreads). If not available, the key public endpoints are:

- GET https://clob.polymarket.com/book?token_id= — orderbook - GET https://clob.polymarket.com/midpoint?token_id= — midpoint price - GET https://clob.polymarket.com/prices-history?market=&interval=1w&fidelity=60 — price history - Get polymarket_token_id from the Simmer market response.

• Other APIs (Synth, NOAA, Binance, RSS, etc.): Ask your human to provide the relevant API docs, or web-fetch them if you have access.

Step 4: Generate the Skill

Create a complete folder on disk:

<skill-slug>/
├── SKILL.md          # AgentSkills-compliant metadata + documentation
├── clawhub.json      # ClawHub + automaton config
├── <script>.py       # Main trading script
└── scripts/
    └── status.py     # Portfolio viewer (copy from references)

SKILL.md Frontmatter (AgentSkills format)

Simmer skills follow the AgentSkills open standard, making them compatible with Claude Code, Cursor, Gemini CLI, VS Code, and other skills-compatible agents.

---
name: <skill-slug>
description: <What it does + when to trigger. Max 1024 chars.>
metadata:
  author: "<author>"
  version: "1.0.0"
  displayName: "<Human Readable Name>"
  difficulty: "intermediate"
---

Rules:

• name must be lowercase, hyphens only, match folder name
• description is required, max 1024 chars
• metadata values must be flat strings (AgentSkills spec)
• NO clawdbot, requires, tunables, or automaton in SKILL.md — those go in clawhub.json
• Body must include: "This is a template" callout, setup flow, configuration table, quick commands, example output, troubleshooting section

clawhub.json (ClawHub + Automaton config)

{
  "emoji": "<emoji>",
  "requires": {
    "env": ["SIMMER_API_KEY"],
    "pip": ["simmer-sdk"]
  },
  "cron": null,
  "autostart": false,
  "automaton": {
    "managed": true,
    "entrypoint": "<script>.py"
  }
}

• simmer-sdk in requires.pip is required — this is what causes the skill to appear in the Simmer registry automatically
• requires.env must include SIMMER_API_KEY
• automaton.entrypoint must point to the main Python script
• tunables — declare every configurable env var here so autotune and the dashboard can surface them. This is the source of truth for tunable ranges and defaults — clawhub_sync propagates them to the skills registry automatically.

Example tunables:

{
  "tunables": [
    {"env": "MY_SKILL_THRESHOLD", "type": "number", "default": 0.15, "range": [0.01, 1.0], "step": 0.01, "label": "Entry threshold"},
    {"env": "MY_SKILL_LOCATIONS", "type": "string", "default": "NYC", "label": "Target cities (comma-separated)"},
    {"env": "MY_SKILL_ENABLED", "type": "boolean", "default": true, "label": "Feature toggle"}
  ]
}

Supported types: number (with range and step), string, boolean. Keep defaults in sync with CONFIG_SCHEMA in your Python script.

Python Script Requirements

Copy these verbatim from references/skill-template.md:

• Config system (from simmer_sdk.skill import load_config, update_config, get_config_path)
• get_client() singleton
• check_context_safeguards()
• execute_trade()
• calculate_position_size()
• CLI entry point with standard args (--live, --positions, --config, --set, --smart-sizing, --no-safeguards, --quiet)

Customize:

• CONFIG_SCHEMA — skill-specific params with SIMMER__ env vars
• TRADE_SOURCE — unique tag like "sdk:"
• SKILL_SLUG — must match the ClawHub slug exactly (e.g., "polymarket-weather-trader")
• Signal logic — your human's strategy
• Market fetching/filtering — how to find relevant markets
• Main strategy function — the core loop

Step 5: Validate

Run the validator against the generated skill:

python /path/to/simmer-skill-builder/scripts/validate_skill.py /path/to/generated-skill/

Fix any FAIL results before delivering to your human.

Step 6: Publish to ClawHub

Once validated, publish the skill so it appears in the Simmer registry automatically:

npx clawhub@latest publish /path/to/generated-skill/ --slug <skill-slug> --version 1.0.0

After publishing, the Simmer sync job picks it up within 6 hours and lists it at simmer.markets/skills. No submission or approval needed — publishing to ClawHub with simmer-sdk as a dependency is all it takes.

Tell your human: > ✅ Skill published to ClawHub. It will appear in the Simmer Skills Registry within 6 hours at simmer.markets/skills.

For full publishing details: simmer.markets/skillregistry.md

Hard Rules

...