Agent skill

Predictfun

by alsk1992 in alsk1992/CloddsBot

Predict.fun prediction market trading (BNB Chain). An agent skill from alsk1992/CloddsBot.

MITAuto-check passedBusiness, Finance & HR

Install Predictfun

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

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

GitHub CLI
$ gh skill install alsk1992/CloddsBot predictfun --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/predictfun .claude/skills/predictfun && 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
predictfun
GitHub stars
2.9k
Token cost
~620 tokens
SKILL.md length
174 words
Files
2
Skills in repo
118
Repo updated
First seen
Licence
MIT

At a glance

Predict.fun prediction market trading (BNB Chain). An agent skill from alsk1992/CloddsBot.

  • Works in 3 steps: Index Sets: Binary markets use indexSet… → Merging: Requires equal amounts of all… → Fees: Check platform for current fee…
  • Tasks that involve Trading and backtesting
  • SKILL.md covers Quick Start, Commands, Configuration and Features, plus 2 more sections
  • Runs TypeScript scripts from its folder; needs PREDICTFUN_API_KEY and PREDICTFUN_PRIVATE_KEY

What it does

Predictfun is an agent skill from alsk1992/CloddsBot. Predict.fun prediction market trading (BNB Chain)

Its SKILL.md is about 620 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 BNB Chain. 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

  • “/predictfun”

Requirements

  • Node.js
  • A credential in PREDICTFUN_API_KEY
  • A credential in PREDICTFUN_PRIVATE_KEY

Workflow steps

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

  1. Index Sets: Binary markets use indexSet = 1 for YES, indexSet = 2 for NO
  2. Merging: Requires equal amounts of all outcome tokens
  3. Fees: Check platform for current fee structure

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

    Links to these hosts (documentation or services it may open):

    • predict.fun
    • bscscan.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • PREDICTFUN_API_KEY
    • PREDICTFUN_PRIVATE_KEY

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

Context cost

Predictfun loads about 620 tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 174 words of instructions outside code blocks.

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

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). 174 words, ~620 tokens.

Download SKILL.mdSave it as .claude/skills/predictfun/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
predictfun
description
Predict.fun prediction market trading (BNB Chain)
emoji
🎯
commands
/pf
gates.envs
PREDICTFUN_API_KEY

Predict.fun

Full integration with Predict.fun, a BNB Chain prediction market with binary and categorical outcomes.

Quick Start

bash
# Set credentials
export PREDICTFUN_API_KEY="your-api-key"
export PREDICTFUN_PRIVATE_KEY="0x..."

# Search markets
/pf markets crypto

# Check balance
/pf balance

# Place order
/pf buy <marketId> YES 0.55 100

Commands

Market Data
CommandDescription
/pf markets [query]Search markets
/pf market <id>Get market details
/pf book <marketId>Show orderbook
Trading
CommandDescription
/pf buy <marketId> <outcome> <price> <size>Place buy order
/pf sell <marketId> <outcome> <price> <size>Place sell order
/pf cancel <orderId>Cancel order
/pf cancelallCancel all orders
/pf ordersList open orders

Examples:

bash
/pf buy market-123 YES 0.55 100   # Buy YES at 55c, 100 shares
/pf sell market-123 NO 0.40 50    # Sell NO at 40c, 50 shares
/pf cancel order-abc              # Cancel specific order
Account
CommandDescription
/pf balanceCheck USDT balance
/pf positionsView open positions
/pf redeem <conditionId>Redeem settled positions
/pf merge <conditionId> <amount>Merge outcome tokens

Configuration

bash
# Required for market data
export PREDICTFUN_API_KEY="your-api-key"

# Required for trading
export PREDICTFUN_PRIVATE_KEY="0x..."

Or in ~/.clodds/clodds.json:

json
{
  "trading": {
    "predictfun": {
      "apiKey": "${PREDICTFUN_API_KEY}",
      "privateKey": "${PREDICTFUN_PRIVATE_KEY}"
    }
  }
}

Features

  • BNB Chain - Fast, low-cost transactions (chainId 56)
  • Binary & Categorical - Multiple market types
  • Order Signing - Secure wallet signatures via SDK
  • Position Management - Track & redeem positions
  • Merge/Split - Convert between collateral and outcome tokens

Trading Notes

  1. Index Sets: Binary markets use indexSet = 1 for YES, indexSet = 2 for NO
  2. Merging: Requires equal amounts of all outcome tokens
  3. Fees: Check platform for current fee structure

Resources

© 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/predictfun of alsk1992/CloddsBot.

  • SKILL.md
  • index.ts

Open the folder on GitHubat commit c930628

Compare with similar skills

Predictfun 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.

Predictfun compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Predictfun this skillalsk1992/CloddsBot2.9k—~620Automated safety check: PassMIT
Notebook To Strategytradingstrategy-ai/trade-executor160—~1.1kAutomated safety check: PassCustom licence
Tushare Datazillionare/zillionare3182 repos~2.3kAutomated safety check: PassNone
Tradingview MCPatilaahmettaner/tradingview-mcp4.9k—~1.3kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle867—~5.9kAutomated safety check: PassMIT
Polyclawchainstacklabs/polyclaw3601 repos~2kAutomated safety check: PassApache-2.0

Similar skills

  • Notebook To Strategy

    tradingstrategy-ai/trade-executor

    Transfer code from a backtesting Jupyter notebook to a Trade Executor strategy module

    160 GitHub stars~1.1k tokensUpdated 7 days ago
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    318 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    4.9k GitHub stars~1.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    867 GitHub stars~5.9k tokensUpdated 2 mo ago
    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
  • Markdown

    facioquo/stock-indicators-dotnet

    Format and lint Markdown in this repository against GitHub Flavored Markdown and its markdownlint-cli2 configuration — headers, lists, code fences, callouts (VitePress containers on docs-site pages…

    1.2k GitHub stars~812 tokensUpdated today
    Business, Finance & HRAuto-check passed

More from alsk1992/CloddsBot

All 118 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 Predictfun

What does Predictfun do?

Predict.fun prediction market trading (BNB Chain). An agent skill from alsk1992/CloddsBot. Predictfun is an agent skill from alsk1992/CloddsBot.

When should I use Predictfun?

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

How do I install Predictfun in Claude Code?

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

How do I install Predictfun in Codex?

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

Can I use Predictfun 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 predictfun -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/predictfun, .gemini/skills/predictfun, .github/skills/predictfun and .opencode/skills/predictfun in your project.

What does Predictfun need to run?

Going by SKILL.md and its folder, Predictfun needs TypeScript for the scripts in its folder and credentials named PREDICTFUN_API_KEY and PREDICTFUN_PRIVATE_KEY. Our summary lists: Node.js; A credential in PREDICTFUN_API_KEY; A credential in PREDICTFUN_PRIVATE_KEY.

Does Predictfun access the network?

SKILL.md names 2 domains. As links in the text: predict.fun and bscscan.com. This is read from the text; nothing was executed.

Is Predictfun 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 Predictfun use?

Predictfun 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 Predictfun use?

About 620 tokens (SKILL.md is roughly 2.5k 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 Predictfun?

Skills that share tags, products or a category with Predictfun: Notebook To Strategy (tradingstrategy-ai/trade-executor, 160 stars), Tushare Data (zillionare/zillionare, 318 stars), Tradingview MCP (atilaahmettaner/tradingview-mcp, 4.9k stars) and Digital Oracle (komako-workshop/digital-oracle, 867 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Predictfun?

alsk1992 (a GitHub user) maintains it in alsk1992/CloddsBot, which has 2,901 GitHub stars. The repository holds 118 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.