SimpleFunctions Agent Skills

Reusable agent skills for working with prediction markets through SimpleFunctions — 37,000+ Kalshi + Polymarket contracts compressed into structured context for LLM agents.

Skills follow the Agent Skills format. Compatible with Claude Code, Cursor, OpenHands, Codex, Gemini CLI, Goose, and any other agent runtime that supports the open SKILL.md spec.

Install

npx skills add spfunctions/agent-skills

After install, your agent can invoke any skill by name (e.g., /sf-research "Fed rate cuts") or pull a context package (e.g., /ctx-fed-monetary).

What's in here

36 skills across three tiers, derived from production SimpleFunctions workflows:

Tier 1 — Workflow skills (12)

Multi-step procedures that wrap common agent jobs.

Skill	Use when
sf-research	Researching a market topic (Fed cuts, election outcome, oil supply)
sf-discover	Finding quality-ranked trade opportunities across venues
sf-inspect	Pulling a full dossier on one ticker
sf-thesis-build	Turning a hypothesis into a causal tree of testable sub-claims
sf-thesis-monitor	Setting up heartbeat monitoring with kill conditions
sf-watch-topic	Creating watchlist + alert + webhook for a topic
sf-portfolio-review	Auditing portfolio state, ticks, trades, strategies
sf-autopilot-setup	Configuring portfolio autopilot with risk gates
sf-pre-trade-check	Adversarial pre-execution discipline gate
sf-discipline-audit	Weekly adversarial review of all open positions
sf-morning	Daily structured briefing (kill conditions, positions, news)
sf-claude-code-setup	Bootstrap Claude Code as a SimpleFunctions agent

Tier 2 — Context packages (16)

Domain-knowledge injection for analyzing markets in a specific theme.

Skill	Theme
ctx-fed-monetary	Fed, FOMC, rates, inflation, dot plot
ctx-elections	US elections, primaries, polling, electoral math
ctx-us-legislative	Senate, House, vote markets, filibuster math
ctx-us-executive	White House, cabinet, executive orders
ctx-us-judicial	SCOTUS, federal courts, opinions calendar
ctx-us-fiscal	Budget, debt ceiling, appropriations
ctx-economic-data	CPI, jobs, GDP, releases calendar
ctx-commodities-energy	Oil, gas, OPEC, weather markets
ctx-climate-energy-policy	IRA, EPA, carbon, clean energy
ctx-crypto	Crypto regulation, stablecoins, token markets
ctx-tech-regulation	Antitrust, AI policy, Section 230
ctx-healthcare	FDA, drug approvals, public health
ctx-immigration	Border, ICE, visa policy
ctx-trade-tariffs	Tariffs, USMCA, China trade
ctx-geopolitical	Iran, Ukraine, Taiwan, sanctions
ctx-sports	NFL, NBA, MLB, sports betting markets

Tier 3 — SDK code patterns (8)

TypeScript code snippets using @spfunctions/sdk and @spfunctions/agent.

Skill	Pattern
sf-sdk-quickstart	Install, manifest inspection, first world.read call
sf-sdk-world-read	Snapshot + delta + watch pattern
sf-sdk-market-research	Discover + inspect via SDK
sf-sdk-econ-gov	FRED + congressional data through SDK
sf-sdk-thesis	Thesis lifecycle (create → signal → evaluate → publish)
sf-sdk-portfolio	Portfolio + intents + execution with risk gates
sf-agent-sdk-quickstart	Agent.create().send().stream() minimum loop
sf-agent-sdk-headless	NDJSON harness for external LLM hosts

How skills are structured

Each skill is a directory with SKILL.md:

skills/
  sf-research/
    SKILL.md
  ctx-fed-monetary/
    SKILL.md
  sf-sdk-quickstart/
    SKILL.md

The SKILL.md uses standard frontmatter (name, description, license) followed by the workflow body. Some Tier 1 + Tier 3 skills include scripts/ or references/ subdirectories for working code samples or supporting context.

SimpleFunctions integration

These skills assume agents have access to:

• CLI — npm install -g @spfunctions/cli (docs)
• SDK — npm install @spfunctions/sdk@0.1.0-alpha.0 (docs)
• Agent SDK — npm install @spfunctions/agent@0.1.0-alpha.0 (docs)
• HTTP API — Free, no auth, base https://simplefunctions.dev/api/ (docs)
• MCP — Adapter at /api/mcp/mcp (docs)

Workflow skills (Tier 1) primarily use the CLI. Context skills (Tier 2) inject domain knowledge with optional CLI tool references. SDK skills (Tier 3) demonstrate the TypeScript packages.

License

CC-BY-4.0. Attribution to SimpleFunctions appreciated.

Links

• Documentation
• Skills catalog API
• GitHub
• X / Twitter

Contributing

Issues and PRs welcome. See CONTRIBUTING.md.