Agent skill

Portfolio

by alsk1992 in alsk1992/CloddsBot

Track your positions and P&L across prediction markets and futures exchanges

MITAuto-check passedBusiness, Finance & HR

Install Portfolio

skills CLI

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

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

GitHub CLI

$ gh skill install alsk1992/CloddsBot portfolio --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/portfolio .claude/skills/portfolio && 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/

Paste into Claude Code

Install the "portfolio" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/portfolio into .claude/skills/portfolio/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "portfolio", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/portfolio

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add alsk1992/CloddsBot --skill portfolio -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install alsk1992/CloddsBot portfolio --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

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

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "portfolio" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/portfolio into .agents/skills/portfolio/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "portfolio", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add alsk1992/CloddsBot --skill portfolio -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install alsk1992/CloddsBot portfolio --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

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

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "portfolio" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/portfolio into .cursor/skills/portfolio/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "portfolio", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/alsk1992/CloddsBot.git --path src/skills/bundled/portfolio

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add alsk1992/CloddsBot --skill portfolio -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install alsk1992/CloddsBot portfolio --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

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

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "portfolio" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/portfolio into .gemini/skills/portfolio/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "portfolio", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install alsk1992/CloddsBot portfolio

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add alsk1992/CloddsBot --skill portfolio -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

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

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "portfolio" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/portfolio into .github/skills/portfolio/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "portfolio", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add alsk1992/CloddsBot --skill portfolio -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install alsk1992/CloddsBot portfolio --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

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

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "portfolio" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/portfolio into .opencode/skills/portfolio/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "portfolio", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: portfolio
GitHub stars: 3k
Token cost: ~911 tokens
SKILL.md length: 265 words
Files: 2
Skills in repo: 116
Repo updated: Oct 2, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Track your positions and P&L across prediction markets and futures exchanges

Business, Finance & HR work in your project
SKILL.md covers Commands, Features, Environment Variables and Examples, plus 1 more section
Runs TypeScript scripts from its folder; needs POLY_API_KEY and POLY_API_SECRET

What it does

Portfolio is an agent skill from alsk1992/CloddsBot. Track your positions and P&L across prediction markets and futures exchanges

Its SKILL.md is about 910 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. It works with Binance. 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

Business, Finance & HR work in your project

Example prompts

“/portfolio”

Requirements

Node.js
A credential in POLY_API_KEY
A credential in POLY_API_SECRET

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 these keys or tokens, usually read from environment variables:
- POLY_API_KEY
- POLY_API_SECRET
- KALSHI_API_KEY
- KALSHI_PRIVATE_KEY
- HL_PRIVATE_KEY
- BINANCE_FUTURES_KEY
- BINANCE_FUTURES_SECRET
- BYBIT_API_KEY
- BYBIT_API_SECRET
- MEXC_API_KEY
- MEXC_API_SECRET
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Portfolio loads about 911 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 265 words of instructions outside code blocks.

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

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). 265 words, ~911 tokens.

Download SKILL.mdSave it as .claude/skills/portfolio/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: portfolio
description: Track your positions and P&L across prediction markets and futures exchanges
emoji: 💼

Portfolio Skill

Track your positions and performance across prediction markets and futures exchanges.

Commands

View Portfolio

/portfolio
/portfolio positions
/portfolio pnl

History

/portfolio history          # Last 7 days (default)
/portfolio history 30d      # Last 30 days
/portfolio history 90d      # Last 90 days

Sync Positions (Auto)

/portfolio sync

Filter by Platform

/portfolio platform polymarket
/portfolio platform binance

Risk

/portfolio risk          # Full risk metrics
/portfolio exposure      # Category exposure breakdown

Features

Position Tracking

Entry price and current price
Shares held
Unrealized P&L ($ and %)
Platform breakdown

Futures Support

Leverage display
Long/Short side indicator
Liquidation price
Notional value
Margin type (cross/isolated)

P&L Summary

Total portfolio value
Daily/weekly/monthly P&L
Best and worst performers
Platform-level P&L

Multi-Platform Support

Prediction Markets:

Polymarket (via API key)
Kalshi (via API key)
Manifold (via API key)

Futures Exchanges:

Hyperliquid (via wallet address + private key)
Binance Futures (via API key + secret)
Bybit (via API key + secret)
MEXC (via API key + secret)

Balance Tracking

Available and locked balance per platform
Polymarket: locked USDC calculated from open buy orders
Futures: margin used vs available

Portfolio History

Snapshots taken automatically during hourly cron sync
ASCII sparkline chart
Start/end value with change ($, %)
Peak and low values
Table of recent data points

Risk Analytics

Correlation Matrix: See how your positions correlate with each other
Category Exposure: Breakdown by politics, crypto, sports, economics, etc.
Concentration Risk: HHI score and diversification metrics
Hedged Pairs: Identify offsetting positions (long YES + short NO)

Whale Tracking Integration

Track what large traders are doing:

/portfolio whales        # Top whales in your markets
/portfolio follow 0x...  # Follow a whale's positions
/portfolio smart-money   # Aggregate whale activity

Crypto Whale Monitoring

Monitor large crypto transactions across chains:

/portfolio crypto-whales          # Recent whale activity
/portfolio crypto-whales solana   # Solana whales only
/portfolio crypto-whales top 10   # Top 10 by volume

Environment Variables

# Prediction Markets
POLY_API_KEY, POLY_API_SECRET, POLY_API_PASSPHRASE
KALSHI_API_KEY, KALSHI_PRIVATE_KEY

# Futures Exchanges
HL_WALLET_ADDRESS, HL_PRIVATE_KEY
BINANCE_FUTURES_KEY, BINANCE_FUTURES_SECRET
BYBIT_API_KEY, BYBIT_API_SECRET
MEXC_API_KEY, MEXC_API_SECRET

Examples

User: "What's my portfolio looking like?" → Show all positions with current prices and P&L

User: "How much am I up today?" → Calculate daily P&L across all positions

User: "What's my exposure to politics markets?" → Filter positions by category, sum exposure

User: "Show my Binance positions" → Filter to Binance futures positions with leverage info

Output Format

Portfolio Summary

Total Value: $12,450
Positions: 8
Unrealized P&L: +$320 (+2.6%)
Realized P&L: $150

Balances:
  polymarket: $2,500 ($2,100 avail, $400 locked)
  binance: $5,000 ($3,200 avail, $1,800 locked)

BTCUSDT Perp [binance]
  LONG 10x: 0.5000 @ $98,500.00
  +$250.00 (+5.1%) | liq $89,100.00

Trump 2028 [polymarket]
  Yes: 100.00 @ $0.520
  +$70.00 (+15.6%)

Files

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

SKILL.md
index.ts

Open the folder on GitHubat commit c930628

Compare with similar skills

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

Portfolio compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Portfolio this skillalsk1992/CloddsBot	3k	—	~911	Automated safety check: Pass	MIT	7 days ago
Fintoolsecond-state/fintool	316	—	~5.9k	Automated safety check: Pass	None	4 mo ago
Academy Skillbinance/binance-skills-hub	1.1k	—	~3.5k	Automated safety check: Notes	None	29 days ago
Binance Sports AI Analyzerbinance/binance-skills-hub	1.1k	—	~2k	Automated safety check: Pass	None	29 days ago
Crypto Market Rankbinance/binance-skills-hub	1.1k	—	~1.6k	Automated safety check: Pass	None	29 days ago
Fiatnpc-live/clawfirm	156	1 repos	~2.1k	Automated safety check: Pass	MIT	3 mo ago

Similar skills

Fintool
second-state/fintool
Financial trading CLIs — spot and perp trading on Hyperliquid, Binance, Coinbase, OKX.
316 GitHub stars~5.9k tokensUpdated 4 mo ago
Business, Finance & HRAuto-check passed
Academy Skill
binance/binance-skills-hub
Retrieve Binance Academy's official educational content (Glossary, Courses, Learn & Earn, Articles) for AI chat.
1.1k GitHub stars~3.5k tokensUpdated 29 days ago
Business, Finance & HRAuto-check: notes
Binance Sports AI Analyzer
binance/binance-skills-hub
A skill your agent uses when users ask for World Cup or 世界杯 AI match predictions, WC assistant probabilities, World Cup news insights, master analysis, recomputing football match win rates with…
1.1k GitHub stars~2k tokensUpdated 29 days ago
Business, Finance & HRAuto-check passed
Crypto Market Rank
binance/binance-skills-hub
Crypto market leaderboards — ranked aggregate feeds across the whole market: social-hype/sentiment rank, trending / top-search / Binance Alpha / tokenized-stocks rank, smart-money net-inflow rank…
1.1k GitHub stars~1.6k tokensUpdated 29 days ago
Business, Finance & HRAuto-check passed
Fiat
npc-live/clawfirm
Query Binance fiat payment capabilities — supported countries, currencies, payment methods, limits, and crypto prices — via public APIs, plus authenticated order/payment history lookup.
156 GitHub starsUsed in 1 repo~2.1k tokens
Business, Finance & HRAuto-check passed
Meme Rush
binance/binance-skills-hub
Live launchpad feed + AI hot topics for meme tokens. An agent skill from binance/binance-skills-hub.
1.1k GitHub stars~1.2k tokensUpdated 29 days ago
Business, Finance & HRAuto-check passed

Questions about Portfolio

What does Portfolio do?

Track your positions and P&L across prediction markets and futures exchanges. Portfolio is an agent skill from alsk1992/CloddsBot.

When should I use Portfolio?

Portfolio fits situations like: business, Finance & HR work in your project.

How do I install Portfolio in Claude Code?

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

How do I install Portfolio in Codex?

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

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

What does Portfolio need to run?

Going by SKILL.md and its folder, Portfolio needs TypeScript for the scripts in its folder and credentials named POLY_API_KEY, POLY_API_SECRET, KALSHI_API_KEY and KALSHI_PRIVATE_KEY. Our summary lists: Node.js; A credential in POLY_API_KEY; A credential in POLY_API_SECRET.

Does Portfolio 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 Portfolio 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 Portfolio use?

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

About 911 tokens (SKILL.md is roughly 3.6k 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 Portfolio?

Skills that share tags, products or a category with Portfolio: Fintool (second-state/fintool, 316 stars), Academy Skill (binance/binance-skills-hub, 1.1k stars), Binance Sports AI Analyzer (binance/binance-skills-hub, 1.1k stars) and Crypto Market Rank (binance/binance-skills-hub, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Portfolio?

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.

Install Portfolio

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Portfolio Skill

Commands

View Portfolio

History

Sync Positions (Auto)

Filter by Platform

Risk

Features

Position Tracking

Futures Support

P&L Summary

Multi-Platform Support

Balance Tracking

Portfolio History

Risk Analytics

Whale Tracking Integration

Crypto Whale Monitoring

Environment Variables

Examples

Output Format

Files

Compare with similar skills

Similar skills

More from alsk1992/CloddsBot

Related

Questions about Portfolio