← Back to Skills Marketplace
Simmer Skills
by
bowen31337
· GitHub ↗
· v1.0.0
· MIT-0
112
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install simmer-skills
Description
Trade prediction market contracts on simmer.markets using virtual or real funds with configurable risk limits and portfolio briefings via API or Python SDK.
Usage Guidance
What to consider before installing:
- This skill will read your local Simmer API key from ~/.config/simmer/credentials.json and will call https://api.simmer.markets to fetch briefings, list markets, and place trades. If you have real funds linked (polymarket), the scripts support USDC trades.
- The package mentions an encrypted private-key file and an external 'fear-harvester' integration that 'decrypts' and switches venue to polymarket. That external script is not included; understand where that decryption would run and who controls it before allowing this skill to run with your keys.
- Metadata vs runtime mismatch: the registry metadata does not declare required credential/config paths, but SKILL.md and scripts require them. SKILL.md also contains an always: true flag which would make the skill load always; verify the platform's effective metadata and avoid enabling always: true unless intentional.
- Safe steps before enabling:
- Inspect the credentials file and ensure you use a dedicated trading wallet (not your main wallet) and minimal funds.
- Run the pipeline in dry-run mode (--dry-run) and ensure no automatic real-money trades occur.
- Audit and sandbox: run the scripts in an isolated environment or container, and confirm no unexpected network endpoints are contacted beyond api.simmer.markets.
- If you plan to use real USDC trading, confirm where and how any private-key decryption is performed and who has access to that decryption code/keys.
- If you are not comfortable reviewing or controlling the private-key decryption/integration, do not install or enable this skill with access to real credentials/funds.
Capability Analysis
Type: OpenClaw Skill
Name: simmer-skills
Version: 1.0.0
The skill bundle provides automated trading capabilities for the Simmer prediction market, including high-risk functionality for real-money USDC transactions on Polymarket. The `SKILL.md` file explicitly directs the AI agent to sensitive file paths containing API credentials (`~/.config/simmer/credentials.json`) and encrypted private keys (`simmer-polymarket-private-key.txt.enc`). While the included Python scripts (`execute.py`, `brief.py`, `score.py`) appear functionally consistent with the stated purpose and incorporate safety rails like trade limits and dry-run modes, the combination of financial asset management and the exposure of sensitive credential locations to the agent's prompt context constitutes a high-risk capability susceptible to prompt injection or accidental financial loss.
Capability Tags
Capability Assessment
Purpose & Capability
The skill's stated purpose (browse, score, and execute trades) matches the included scripts which call simmer API endpoints. However the SKILL.md and scripts rely on a local credentials file (~/.config/simmer/credentials.json) and reference a private-key file under ~/.openclaw/workspace/memory/encrypted/simmer-polymarket-private-key.txt.enc. The registry metadata declared no required config paths or credentials, so required sensitive files are not declared in metadata — a coherence problem.
Instruction Scope
SKILL.md and the Python scripts explicitly instruct the agent to read the local credentials file to extract an API key and to call api.simmer.markets endpoints (briefing, markets, trade). SKILL.md also mentions a claimed agent, a private key path, and an external 'fear-harvester' script that will decrypt the private key and set venue='polymarket' automatically — that external integration is not included in this bundle. Instructions therefore access and rely on local secret files and external components beyond the skill bundle.
Install Mechanism
This is an instruction-only skill with bundled Python scripts and no installer spec — lowest risk from an installer perspective. README suggests installing simmer-sdk via pip (typo 'uv pip install' in README), but there is no opaque download or extract behavior in the package.
Credentials
The runtime requires access to an API key stored in ~/.config/simmer/credentials.json and the SKILL.md references a path to an encrypted private key for real-money trading. None of these config paths or secrets are declared in the registry metadata (requires.env/required config paths are empty). The skill is capable of executing real USDC trades (execute.py supports USDC venues) but the metadata gives no indication that such high-sensitivity credentials are required.
Persistence & Privilege
SKILL.md includes a top-level metadata.openclaw block setting always: true, which would force the skill to be loaded always; the registry flags show always: false, so there is a mismatch. An always-loaded trading skill that can access local credentials increases blast radius. The scripts also write a local trade_log.jsonl under the skill workspace (normal for a trading pipeline but noteworthy).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install simmer-skills - After installation, invoke the skill by name or use
/simmer-skills - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the Simmer skill for prediction market trading.
- Provides setup instructions for API credentials and Python SDK usage.
- Includes quick command-line and Python examples for health checks, status, browsing, and trading.
- Supports both virtual ($SIM) and real-money (Polymarket USDC.e) trading.
- Automated heartbeat script for portfolio and risk monitoring.
- Built-in safety rails for trade limits and risk management.
Metadata
Frequently Asked Questions
What is Simmer Skills?
Trade prediction market contracts on simmer.markets using virtual or real funds with configurable risk limits and portfolio briefings via API or Python SDK. It is an AI Agent Skill for Claude Code / OpenClaw, with 112 downloads so far.
How do I install Simmer Skills?
Run "/install simmer-skills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Simmer Skills free?
Yes, Simmer Skills is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Simmer Skills support?
Simmer Skills is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Simmer Skills?
It is built and maintained by bowen31337 (@bowen31337); the current version is v1.0.0.
More Skills