mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-05-13 03:52:00 +00:00

Teknium 98db898c0b feat(skills): declare platforms frontmatter for all 79 undeclared built-in skills

Completes the Windows-gating coverage for the built-in skills/ tree. Every
bundled SKILL.md now carries an explicit platforms: declaration so the
loader (agent.skill_utils.skill_matches_platform) can skip-load skills
that don't fit the current OS.

74 skills declared cross-platform (platforms: [linux, macos, windows]):
  Creative (16): ascii-art, ascii-video, architecture-diagram, baoyu-comic,
    baoyu-infographic, claude-design, creative-ideation, design-md,
    excalidraw, humanizer, manim-video, p5js, pixel-art,
    popular-web-designs, pretext, sketch, songwriting-and-ai-music,
    touchdesigner-mcp
  Autonomous agents: claude-code, codex, hermes-agent, opencode
  Data/devops: jupyter-live-kernel, kanban-orchestrator, kanban-worker,
    webhook-subscriptions, dogfood, codebase-inspection
  GitHub: github-auth, github-code-review, github-issues,
    github-pr-workflow, github-repo-management
  Media: gif-search, heartmula, songsee, spotify, youtube-content
  MCP / email / gaming / notes / smart-home: native-mcp, himalaya,
    pokemon-player, obsidian, openhue
  mlops (non-broken): weights-and-biases, huggingface-hub, llama-cpp,
    outlines, segment-anything-model, dspy, trl-fine-tuning
  Productivity: airtable, google-workspace, linear, maps, nano-pdf,
    notion, ocr-and-documents, powerpoint
  Red-teaming / research: godmode, arxiv, blogwatcher, llm-wiki,
    polymarket
  Software-dev: debugging-hermes-tui-commands, hermes-agent-skill-authoring,
    node-inspect-debugger, plan, requesting-code-review, spike,
    subagent-driven-development, systematic-debugging,
    test-driven-development, writing-plans
  Misc: yuanbao

5 skills gated from Windows (platforms: [linux, macos]):
  mlops/inference/vllm (serving-llms-vllm)
    vLLM is officially Linux-only; Windows requires WSL.
  mlops/training/axolotl
    Axolotl's flash-attn + deepspeed + bitsandbytes stack is Linux-first.
  mlops/training/unsloth
    Requires Triton + xformers + flash-attn — Linux only in practice.
  mlops/models/audiocraft (audiocraft-audio-generation)
    torchaudio ffmpeg backend + encodec dependencies are Linux-first.
  mlops/inference/obliteratus
    Research abliteration workflow; relies on Linux-focused pytorch
    kernels and MLX — no first-class Windows path.

Same strict-over-lenient policy as the optional-skills sweep: when the
underlying tool's Windows support is rough, missing, or WSL-only, gate the
skill. Easier to un-gate after verified Windows support lands than to leak
partial support that manifests as mid-task failures.

Combined with prior commits in this branch, every bundled SKILL.md
(skills/ + optional-skills/) now has a platforms: declaration.

2026-05-08 14:27:40 -07:00

2.9 KiB

Raw Blame History

name

description

version

author

Polymarket — Prediction Market Data

Query prediction market data from Polymarket using their public REST APIs. All endpoints are read-only and require zero authentication.

See references/api-endpoints.md for the full endpoint reference with curl examples.

When to Use

User asks about prediction markets, betting odds, or event probabilities
User wants to know "what are the odds of X happening?"
User asks about Polymarket specifically
User wants market prices, orderbook data, or price history
User asks to monitor or track prediction market movements

Key Concepts

Events contain one or more Markets (1:many relationship)
Markets are binary outcomes with Yes/No prices between 0.00 and 1.00
Prices ARE probabilities: price 0.65 means the market thinks 65% likely
outcomePrices field: JSON-encoded array like ["0.80", "0.20"]
clobTokenIds field: JSON-encoded array of two token IDs [Yes, No] for price/book queries
conditionId field: hex string used for price history queries
Volume is in USDC (US dollars)

Three Public APIs

Gamma API at gamma-api.polymarket.com — Discovery, search, browsing
CLOB API at clob.polymarket.com — Real-time prices, orderbooks, history
Data API at data-api.polymarket.com — Trades, open interest

Typical Workflow

When a user asks about prediction market odds:

Search using the Gamma API public-search endpoint with their query
Parse the response — extract events and their nested markets
Present market question, current prices as percentages, and volume
Deep dive if asked — use clobTokenIds for orderbook, conditionId for history

Presenting Results

Format prices as percentages for readability:

outcomePrices ["0.652", "0.348"] becomes "Yes: 65.2%, No: 34.8%"
Always show the market question and probability
Include volume when available

Example: "Will X happen?" — 65.2% Yes ($1.2M volume)

Parsing Double-Encoded Fields

The Gamma API returns outcomePrices, outcomes, and clobTokenIds as JSON strings inside JSON responses (double-encoded). When processing with Python, parse them with json.loads(market['outcomePrices']) to get the actual array.

Rate Limits

Generous — unlikely to hit for normal usage:

Gamma: 4,000 requests per 10 seconds (general)
CLOB: 9,000 requests per 10 seconds (general)
Data: 1,000 requests per 10 seconds (general)

Limitations

This skill is read-only — it does not support placing trades
Trading requires wallet-based crypto authentication (EIP-712 signatures)
Some new markets may have empty price history
Geographic restrictions apply to trading but read-only data is globally accessible

2.9 KiB Raw Blame History