Agent skill

Divergence

by alsk1992 in alsk1992/CloddsBot

Spot vs Polymarket divergence trading on 15-minute crypto markets

MITAuto-check passedBusiness, Finance & HR

Install Divergence

skills CLI
$ npx skills add alsk1992/CloddsBot --skill divergence -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alsk1992/CloddsBot divergence --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alsk1992/CloddsBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/skills/bundled/divergence .claude/skills/divergence && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
divergence
GitHub stars
2.9k
Token cost
~583 tokens
SKILL.md length
179 words
Files
2
Skills in repo
116
Repo updated
First seen
Licence
MIT

At a glance

Spot vs Polymarket divergence trading on 15-minute crypto markets

  • Works in 3 steps: Look up spot price N seconds ago via… → Calculate spotMovePct = (now - then) /… → If move >= threshold AND poly is fresh…
  • Tasks that involve Trading and backtesting
  • SKILL.md covers Quick Start, Commands, Detection Algorithm and Threshold Buckets, plus 1 more section
  • Runs TypeScript scripts from its folder

What it does

Divergence is an agent skill from alsk1992/CloddsBot. Spot vs Polymarket divergence trading on 15-minute crypto markets

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `index.ts`).

It sits in Business, Finance & HR, covering Trading and backtesting. It works with Polymarket. The repository describes itself as: Open Source AI trading agent that operates autonomously across 1000+ markets - Polymarket, Kalshi, Binance, Hyperliquid, Solana DEXs, 5 EVM chains. Scans for edge, executes… The licence is MIT.

When your agent uses it

  • Tasks that involve Trading and backtesting

Example prompts

  • “/divergence”

Requirements

  • Node.js
  • A credential in POLY_PRIVATE_KEY
  • A credential in POLY_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Look up spot price N seconds ago via binary search
  2. Calculate spotMovePct = (now - then) / then * 100
  3. If move >= threshold AND poly is fresh (< 5s stale)

What it can do on your machine

Read from SKILL.md and the folder at commit c930628. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (TypeScript), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Divergence loads about 583 tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 179 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~19
When it runs · the whole SKILL.md, loaded when a task matches
~583

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alsk1992/CloddsBot at commit c930628, republished under its MIT licence (© alsk1992). 179 words, ~583 tokens.

Download SKILL.mdSave it as .claude/skills/divergence/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
divergence
description
Spot vs Polymarket divergence trading on 15-minute crypto markets
commands
/divergence, /div
gates.envs
POLY_PRIVATE_KEY, POLY_FUNDER_ADDRESS, POLY_API_KEY, POLY_API_SECRET, POLY_API_PASSPHRASE

Divergence Trading - Spot vs Poly Price Lag

Detects when Binance spot prices move but Polymarket 15-minute binary markets haven't caught up yet. Buys the lagging side and sells when it corrects.

Strategy tags match the CLAUDE.md encoding: BTC_DOWN_s12-14_w15 (0.12-0.14% move in 15s window).

Starts in dry-run mode by default (no real orders).

Quick Start

/div start                     # Dry-run on BTC,ETH,SOL,XRP
/div start BTC,ETH --size 30   # Specific assets + size
/div status                    # Stats, open positions
/div stop                      # Stop and show summary

Commands

Start / Stop
/div start [ASSETS] [--size N] [--dry-run]
/div stop
Monitor
/div status       Stats + open positions + round info
/div positions    Last 20 closed trades with strategy tags
/div markets      Active 15-min markets from Gamma API
Configure
/div config                           Show current config
/div config --tp 20 --sl 30          Set TP/SL %
/div config --size 50                 Set trade size
/div config --windows 5,10,30         Set detection windows

Detection Algorithm

For each spot tick, across all configured windows (5s, 10s, 15s, 30s, 60s, 90s, 120s):

  1. Look up spot price N seconds ago via binary search
  2. Calculate spotMovePct = (now - then) / then * 100
  3. If move >= threshold AND poly is fresh (< 5s stale):
    • Generate signal with strategy tag: {ASSET}_{DIR}_s{bucket}_w{window}
    • e.g., BTC_DOWN_s12-14_w15 = 0.12-0.14% spot drop over 15s

Threshold Buckets

BucketSpot Move Range
s08-100.08% - 0.10%
s10-120.10% - 0.12%
s12-140.12% - 0.14%
s14-160.14% - 0.16%
s16-200.16% - 0.20%
s20+0.20%+

Exit Logic

  1. Force exit — < 30s before market expiry
  2. Take profit — PnL >= 15% (configurable)
  3. Stop loss — PnL <= -25% (configurable)
  4. Trailing stop — Activated at +10%, exits if drops 8% from HWM
  5. Time exit — < 2min before expiry

© alsk1992, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in src/skills/bundled/divergence of alsk1992/CloddsBot.

  • SKILL.md
  • index.ts

Open the folder on GitHubat commit c930628

Compare with similar skills

Divergence next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Divergence compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Divergence this skillalsk1992/CloddsBot2.9k—~583Automated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle870—~5.9kAutomated safety check: PassMIT
Fintoolsecond-state/fintool3161 repos~5.9kAutomated safety check: PassNone
Polyclawchainstacklabs/polyclaw3601 repos~2kAutomated safety check: PassApache-2.0
Polymarket TradingBlockRunAI/ClawRouter6.6k—~1.4kAutomated safety check: PassMIT
Dr Manhattanguzus/dr-manhattan204—~2kAutomated safety check: PassApache-2.0

Similar skills

  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    870 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Fintool

    second-state/fintool

    Financial trading CLIs — spot and perp trading on Hyperliquid, Binance, Coinbase, OKX.

    316 GitHub starsUsed in 1 repo~5.9k tokens
    Business, Finance & HRAuto-check passed
  • Polyclaw

    chainstacklabs/polyclaw

    Trade on Polymarket via split + CLOB execution. An agent skill from chainstacklabs/polyclaw.

    360 GitHub starsUsed in 1 repo~2k tokens
    Business, Finance & HRAuto-check passed
  • Polymarket Trading

    BlockRunAI/ClawRouter

    A skill your agent uses when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools).

    6.6k GitHub stars~1.4k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed
  • Dr Manhattan

    guzus/dr-manhattan

    Trade prediction markets (Polymarket, Kalshi, Opinion, Limitless, Predict.fun) using a unified CCXT-style API.

    204 GitHub stars~2k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Polymarket Tennis

    livetennisapi/livetennisapi-mcp

    Build observe-only Polymarket and Kalshi tennis market tooling on the polymarket-tennis Python package (MIT) plus the Live Tennis API free tier.

    152 GitHub stars~3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from alsk1992/CloddsBot

All 116 skills in this repo
  • Qmd

    alsk1992/CloddsBot

    Local hybrid search for markdown notes and docs. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub starsUsed in 3 repos~1.2k tokens
    Auto-check passed
  • Drift SDK

    alsk1992/CloddsBot

    Drift Protocol perpetual futures trading on Solana (direct SDK)

    2.9k GitHub starsUsed in 1 repo~625 tokens
    Auto-check passed
  • Edge

    alsk1992/CloddsBot

    Find mispriced markets by comparing to external models and data sources

    2.9k GitHub starsUsed in 1 repo~472 tokens
    Auto-check passed
  • Embeddings

    alsk1992/CloddsBot

    Vector embeddings configuration and semantic search. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • News

    alsk1992/CloddsBot

    Monitor news and correlate with prediction market movements. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub starsUsed in 1 repo~462 tokens
    Auto-check passed
  • Opportunity

    alsk1992/CloddsBot

    Find and execute cross-platform arbitrage opportunities across prediction markets

    2.9k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

Works with

Questions about Divergence

What does Divergence do?

Spot vs Polymarket divergence trading on 15-minute crypto markets. Divergence is an agent skill from alsk1992/CloddsBot.

When should I use Divergence?

Divergence fits situations like: tasks that involve Trading and backtesting.

How do I install Divergence in Claude Code?

Run `npx skills add alsk1992/CloddsBot --skill divergence -a claude-code`. Or copy the skill folder (src/skills/bundled/divergence in alsk1992/CloddsBot) into .claude/skills/divergence in your project. Claude Code loads it when a task matches its description.

How do I install Divergence in Codex?

Run `npx skills add alsk1992/CloddsBot --skill divergence -a codex`. Or copy the skill folder (src/skills/bundled/divergence in alsk1992/CloddsBot) into .agents/skills/divergence in your project. Codex loads it when a task matches its description.

Can I use Divergence in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alsk1992/CloddsBot --skill divergence -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/divergence, .gemini/skills/divergence, .github/skills/divergence and .opencode/skills/divergence in your project.

What does Divergence need to run?

Going by SKILL.md and its folder, Divergence needs TypeScript for the scripts in its folder. Our summary lists: Node.js; A credential in POLY_PRIVATE_KEY; A credential in POLY_API_KEY.

Does Divergence access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Divergence safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Divergence use?

Divergence is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Divergence use?

About 583 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Divergence?

Skills that share tags, products or a category with Divergence: Digital Oracle (komako-workshop/digital-oracle, 870 stars), Fintool (second-state/fintool, 316 stars), Polyclaw (chainstacklabs/polyclaw, 360 stars) and Polymarket Trading (BlockRunAI/ClawRouter, 6.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Divergence?

alsk1992 (a GitHub user) maintains it in alsk1992/CloddsBot, which has 2,903 GitHub stars. The repository holds 116 skills in this directory. The repository was last updated on October 2, 2026.

Source: alsk1992/CloddsBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.