Agent skill

Market Index

by alsk1992 in alsk1992/CloddsBot

Search, discover, and browse indexed markets across all platforms

MITAuto-check passed

Install Market Index

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

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

GitHub CLI
$ gh skill install alsk1992/CloddsBot market-index --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/market-index .claude/skills/market-index && 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
market-index
GitHub stars
3k
Token cost
~1.6k tokens
SKILL.md length
180 words
Files
2
Skills in repo
116
Repo updated
First seen
Licence
MIT

At a glance

Search, discover, and browse indexed markets across all platforms

  • Works in 5 steps: Refresh regularly - Markets change… → Use filters - Narrow down large result… → Check liquidity - Not just volume → …
  • SKILL.md covers Chat Commands, TypeScript API Reference, Categories and Search Syntax, plus 2 more sections
  • Runs TypeScript scripts from its folder

What it does

Market Index is an agent skill from alsk1992/CloddsBot. Search, discover, and browse indexed markets across all platforms

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

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.

Example prompts

  • “/market-index”

Requirements

  • Node.js

Workflow steps

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

  1. Refresh regularly - Markets change frequently
  2. Use filters - Narrow down large result sets
  3. Check liquidity - Not just volume
  4. Monitor new markets - Opportunities in new listings
  5. Track closing dates - Don't miss resolution

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

Market Index loads about 1.6k tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 180 words of instructions outside code blocks.

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

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). 180 words, ~1,600 tokens.

Download SKILL.mdSave it as .claude/skills/market-index/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
market-index
description
Search, discover, and browse indexed markets across all platforms
emoji
🔍

Market Index - Complete API Reference

Search, discover, and browse markets across all prediction market platforms with advanced filtering and categorization.


Chat Commands

/index search "trump"                       # Search all indexed markets
/index search "election" --platform poly    # Search specific platform
/index search "fed rate" --category finance # Filter by category
/index search "crypto" --min-volume 10000   # Min volume filter
/index search "sports" --active-only        # Active markets only
Browse Categories
/index categories                           # List all categories
/index category politics                    # Browse politics markets
/index category crypto                      # Browse crypto markets
/index category sports                      # Browse sports markets
/index trending                             # Trending markets
Market Discovery
/index new                                  # Newly created markets
/index new --last 24h                       # Last 24 hours
/index hot                                  # High activity markets
/index closing-soon                         # Markets ending soon
Index Management
/index update                               # Refresh market index
/index update poly                          # Update specific platform
/index stats                                # Index statistics
/index status                               # Index health status

TypeScript API Reference

Create Market Index
typescript
import { createMarketIndex } from 'clodds/market-index';

const index = createMarketIndex({
  platforms: ['polymarket', 'kalshi', 'manifold', 'betfair'],

  // Auto-refresh
  autoRefresh: true,
  refreshIntervalMs: 300000,  // 5 minutes

  // Storage
  cachePath: './market-index.db',
});
Search Markets
typescript
// Full-text search
const results = await index.search('trump election', {
  platforms: ['polymarket', 'kalshi'],
  limit: 20,
  sortBy: 'volume',  // 'volume' | 'relevance' | 'endDate' | 'created'
});

for (const market of results) {
  console.log(`[${market.platform}] ${market.question}`);
  console.log(`  Category: ${market.category}`);
  console.log(`  Volume: $${market.volume.toLocaleString()}`);
  console.log(`  End: ${market.endDate}`);
}

// With filters
const filtered = await index.search('', {
  category: 'politics',
  minVolume: 10000,
  activeOnly: true,
  endsBefore: '2024-12-31',
});
Browse Categories
typescript
// Get all categories
const categories = await index.getCategories();

for (const cat of categories) {
  console.log(`${cat.name}: ${cat.marketCount} markets`);
}

// Get markets in category
const politics = await index.getMarketsByCategory('politics', {
  limit: 50,
  sortBy: 'volume',
});
Market Discovery
typescript
// Get new markets
const newMarkets = await index.getNewMarkets({
  since: Date.now() - 24 * 60 * 60 * 1000,  // Last 24h
  limit: 20,
});

// Get trending/hot markets
const trending = await index.getTrendingMarkets({
  period: '24h',
  limit: 10,
});

for (const market of trending) {
  console.log(`${market.question}`);
  console.log(`  Volume 24h: $${market.volume24h.toLocaleString()}`);
  console.log(`  Volume change: ${market.volumeChange > 0 ? '+' : ''}${market.volumeChange}%`);
}

// Markets closing soon
const closingSoon = await index.getClosingSoon({
  within: '48h',
  minVolume: 1000,
});
Index Management
typescript
// Update index
await index.update();

// Update specific platform
await index.update('polymarket');

// Get index stats
const stats = await index.getStats();

console.log(`Total markets: ${stats.totalMarkets}`);
console.log(`By platform:`);
for (const [platform, count] of Object.entries(stats.byPlatform)) {
  console.log(`  ${platform}: ${count}`);
}
console.log(`By category:`);
for (const [category, count] of Object.entries(stats.byCategory)) {
  console.log(`  ${category}: ${count}`);
}
console.log(`Last updated: ${stats.lastUpdated}`);

// Check status
const status = await index.getStatus();
console.log(`Status: ${status.status}`);
console.log(`Markets indexed: ${status.marketCount}`);
console.log(`Index age: ${status.ageMinutes} minutes`);
Get Single Market
typescript
// Get market details
const market = await index.getMarket('polymarket', 'market-123');

console.log(`Question: ${market.question}`);
console.log(`Description: ${market.description}`);
console.log(`Category: ${market.category}`);
console.log(`Platform: ${market.platform}`);
console.log(`Volume: $${market.volume.toLocaleString()}`);
console.log(`Liquidity: $${market.liquidity.toLocaleString()}`);
console.log(`Start: ${market.startDate}`);
console.log(`End: ${market.endDate}`);
console.log(`Outcomes: ${market.outcomes.join(', ')}`);

Categories

Standard categories across platforms:

CategoryDescription
politicsElections, policy, government
cryptoCryptocurrency prices, events
financeFed rates, stocks, economy
sportsGames, tournaments, awards
entertainmentMovies, TV, celebrities
scienceResearch, space, climate
technologyTech companies, products
worldInternational events
otherMiscellaneous

Search Syntax

SyntaxExampleDescription
Keywordstrump electionMatch any word
Exact phrase"federal reserve"Match exact phrase
Excludeelection -trumpExclude word
Platform filterplatform:polySpecific platform
Category filtercategory:politicsSpecific category

Sorting Options

OptionDescription
volumeHighest volume first
relevanceBest match first
endDateEnding soonest first
createdNewest first
liquidityHighest liquidity first

Best Practices

  1. Refresh regularly - Markets change frequently
  2. Use filters - Narrow down large result sets
  3. Check liquidity - Not just volume
  4. Monitor new markets - Opportunities in new listings
  5. Track closing dates - Don't miss resolution

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

  • SKILL.md
  • index.ts

Open the folder on GitHubat commit c930628

Compare with similar skills

Market Index 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.

Market Index compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Market Index this skillalsk1992/CloddsBot3k—~1.6kAutomated safety check: PassMIT
Marketing Campaignaffaan-m/ECC277k1 repos~1.3kAutomated safety check: PassMIT
Market Researchalirezarezvani/claude-skills28k—~2.6kAutomated safety check: PassMIT
Indexabilitythedaviddias/Front-End-Checklist74k—~814Automated safety check: PassMIT
Market Sizing Analysiswshobson/agents40k1 repos~620Automated safety check: PassMIT
Market Researchaffaan-m/ECC277k3 repos~216Automated safety check: PassMIT

Similar skills

  • Marketing Campaign

    affaan-m/ECC

    End-to-end marketing campaign planning and execution. An agent skill from affaan-m/ECC.

    277k GitHub starsUsed in 1 repo~1.3k tokens
    Marketing & SEOAuto-check passed
  • Market Research

    alirezarezvani/claude-skills

    A skill your agent uses when doing upstream market-research methodology — sizing a market as TAM/SAM/SOM computed BOTH top-down and bottoms-up (never a single unsourced number), planning a survey…

    28k GitHub stars~2.6k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Indexability

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site for accidental noindex directives, investigating why important pages are not appearing in Google Search, or reviewing CMS settings that control indexing…

    74k GitHub stars~814 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • Market Sizing Analysis

    wshobson/agents

    Calculate TAM/SAM/SOM for market opportunities using top-down, bottom-up, and value theory methodologies.

    40k GitHub starsUsed in 1 repo~620 tokens
    Product & Project ManagementAuto-check passed
  • Market Research

    affaan-m/ECC

    进行市场研究、竞争分析、投资者尽职调查和行业情报,附带来源归属和决策导向的摘要。适用于用户需要市场规模、竞争对手比较、基金研究、技术扫描或为商业决策提供信息的研究时。

    277k GitHub starsUsed in 3 repos~216 tokens
    Marketing & SEOAuto-check passed
  • Market Ingest

    ruvnet/ruflo

    Ingest and normalize market data into OHLCV vectors with HNSW indexing

    74k GitHub stars~529 tokensUpdated yesterday
    DatabasesAuto-check: notes

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.

    3k GitHub starsUsed in 3 repos~1.2k tokens
    Auto-check passed
  • AI Strategy

    alsk1992/CloddsBot

    AI Strategy - natural language to trades. An agent skill from alsk1992/CloddsBot.

    3k GitHub stars~670 tokensUpdated 8 days ago
    Auto-check passed
  • Alerts

    alsk1992/CloddsBot

    Create and manage price alerts for prediction markets. An agent skill from alsk1992/CloddsBot.

    3k GitHub stars~460 tokensUpdated 8 days ago
    Auto-check passed
  • Analytics

    alsk1992/CloddsBot

    Performance attribution, trade analytics, and strategy optimization

    3k GitHub stars~1.6k tokensUpdated 8 days ago
    Auto-check passed
  • Arbitrage

    alsk1992/CloddsBot

    Automated cross-platform arbitrage detection and monitoring. An agent skill from alsk1992/CloddsBot.

    3k GitHub stars~1.7k tokensUpdated 8 days ago
    Auto-check passed
  • Auto Reply

    alsk1992/CloddsBot

    Automatic response rules, patterns, and scheduled messages. An agent skill from alsk1992/CloddsBot.

    3k GitHub stars~1.5k tokensUpdated 8 days ago
    Auto-check passed

Questions about Market Index

What does Market Index do?

Search, discover, and browse indexed markets across all platforms. Market Index is an agent skill from alsk1992/CloddsBot.

How do I install Market Index in Claude Code?

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

How do I install Market Index in Codex?

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

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

What does Market Index need to run?

Going by SKILL.md and its folder, Market Index needs TypeScript for the scripts in its folder. Our summary lists: Node.js.

Does Market Index 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 Market Index 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 Market Index use?

Market Index 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 Market Index use?

About 1.6k tokens (SKILL.md is roughly 6.4k 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 Market Index?

Skills that share tags, products or a category with Market Index: Marketing Campaign (affaan-m/ECC, 277k stars), Market Research (alirezarezvani/claude-skills, 28k stars), Indexability (thedaviddias/Front-End-Checklist, 74k stars) and Market Sizing Analysis (wshobson/agents, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Market Index?

alsk1992 (a GitHub user) maintains it in alsk1992/CloddsBot, which has 2,951 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.