Agent skill

Trade Thesis

by Superior-Trade in Superior-Trade/superior-skills

A skill your agent uses when a user proposes a trade idea, asks "should I trade X", wants a bull/bear case, conviction check, trade plan or pre-trade analysis, or before deploying any new strategy…

MITAuto-check passedEducation

Install Trade Thesis

skills CLI
$ npx skills add Superior-Trade/superior-skills --skill trade-thesis -a claude-code

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

GitHub CLI
$ gh skill install Superior-Trade/superior-skills trade-thesis --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/Superior-Trade/superior-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/trade-thesis .claude/skills/trade-thesis && 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
trade-thesis
GitHub stars
215
Token cost
~1.9k tokens
SKILL.md length
1,110 words
Files
1
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when a user proposes a trade idea, asks "should I trade X", wants a bull/bear case, conviction check, trade plan or pre-trade analysis, or before deploying any new strategy…

  • Works in 6 steps: Thesis statement → Bull case → Bear case → …
  • A user proposes a trade idea
  • SKILL.md covers When to produce a thesis, When to skip, Thesis format and Example thesis
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Trade Thesis is an agent skill from Superior-Trade/superior-skills. Use when a user proposes a trade idea, asks "should I trade X", wants a bull/bear case, conviction check, trade plan or pre-trade analysis, or before deploying any new strategy live for the first time. Builds a structured thesis: bull and bear cases, invalidation criteria, and a sizing rationale.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Education, covering Essays and academic help and Trading and backtesting. The repository describes itself as: Open agent skills and tool schemas for Superior Trade — build, backtest, and deploy trading strategies on Hyperliquid. The licence is MIT.

When your agent uses it

  • A user proposes a trade idea
  • Asks should I trade X
  • Wants a bull/bear case
  • Conviction check

Example prompts

  • “should I trade X”
  • “/trade-thesis”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Thesis statement
  2. Bull case
  3. Bear case
  4. Invalidation level
  5. Data check
  6. Position sizing rationale

What it can do on your machine

Read from SKILL.md and the folder at commit 9d41db5. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Trade Thesis loads about 1.9k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 1,110 words of instructions outside code blocks.

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

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 Superior-Trade/superior-skills at commit 9d41db5, republished under its MIT licence (© Superior-Trade). 1,110 words, ~1,908 tokens.

Download SKILL.mdSave it as .claude/skills/trade-thesis/SKILL.md (or your agent's skills folder).
name
trade-thesis
description
Use when a user proposes a trade idea, asks "should I trade X", wants a bull/bear case, conviction check, trade plan or pre-trade analysis, or before deploying any new strategy live for the first time. Builds a structured thesis: bull and bear cases, invalidation criteria, and a sizing rationale.
metadata.version
0.1.0
metadata.updated
2026-06-07

Pre-Trade Thesis Builder

A structured framework the agent produces before any live deployment of a new strategy idea. Forces two-sided analysis and a measurable invalidation level so every trade has a thesis that can be killed.

When to produce a thesis

  • The user proposes a new trade idea ("I want to long ETH", "thinking about a funding squeeze on SOL")
  • The user asks "should I trade X" or "is this a good setup"
  • The agent is about to deploy a new strategy to live for the first time
  • The user explicitly asks for a bull/bear case, conviction check, or pre-trade analysis

When to skip

  • Backtests and parameter sweeps — the thesis is for live capital, not for exploring an idea
  • Dry-run / paper deployments — no real money at risk
  • Copy-trading — the thesis belongs to the source trader, not the copier
  • Re-deploying a previously validated strategy — if the user already ran this setup live and is restarting it, skip unless market conditions changed materially

Thesis format

Produce all six sections below. Each section is 2-4 bullet points max. This is a pre-trade checklist, not a research paper.

1. Thesis statement

One sentence: what is the bet, which direction, what timeframe.

Force clarity. "Long ETH perp on a funding squeeze setup, targeting a 3-5% move over 24-48h" is a thesis. "ETH looks bullish" is not.

2. Bull case

2-3 concrete reasons this trade works. Every reason must reference observable, checkable data:

  • Price action the agent can verify via price_check (e.g., "price reclaimed the 4h EMA-50 and is holding above")
  • Volume dynamics via volume_momentum_check (e.g., "RVOL is 2.3x on the breakout candle")
  • Funding / OI via the alpha scan (e.g., "funding APR is -18%, shorts are paying 0.002% per hour")
  • On-chain flows if available (e.g., "exchange outflows spiked 3x over 24h")

No vague claims like "market sentiment is improving" or "BTC looks strong." If it cannot be checked with a tool call, it does not belong in the bull case.

3. Bear case

2-3 concrete reasons this trade fails. Same data-grounding rules as the bull case.

The agent must argue AGAINST the trade honestly. This is adversarial analysis, not a strawman disclaimer. Examples of real bear points:

  • "Funding is negative but OI is declining — shorts are closing, not getting squeezed. The fuel is draining."
  • "RVOL is elevated but the move happened on a single 15m candle — no follow-through across multiple sessions."
  • "BTC is sitting at the 200-day moving average with a bearish divergence on 4h RSI. A rejection here takes alts down 10-15%."
4. Invalidation level

A specific, measurable condition that kills the thesis. This becomes the logical stoploss anchor.

Acceptable invalidation criteria:

  • A price level: "Below $3,420 the reclaim is failed — thesis dead."
  • A funding flip: "If funding APR crosses above 0% before the move, the squeeze pressure is gone."
  • An RVOL collapse: "If RVOL drops below 1.0x within 4 hours of entry, the momentum thesis is invalidated."
  • A time deadline: "If price hasn't moved +2% within 24h, the catalyst is stale — cut."

The stoploss in the deployment config should be anchored to this level, not an arbitrary percentage.

5. Data check

Which agent tools to call right now to verify the thesis before proceeding:

CheckToolWhat to look for
Current price and recent structureprice_checkIs price where the thesis assumes it is? Has structure changed since the idea was formed?
Volume and momentumvolume_momentum_checkRVOL level, momentum acceleration/deceleration, any divergence
Available capitalbalance_checkMain wallet balance on Hyperliquid — enough for the proposed stake?
Pair rankingalpha_scanWhere does this pair sit in the current scan? Is the setup confirmed or fading?
Pair tradabilitypair_validateIs the pair active on Hyperliquid? What are the margin requirements and minimum order size?

Run these checks and update the bull/bear case with the results before proceeding. If the data contradicts the thesis, say so.

Show full SKILL.md (472 more words)Show less
6. Position sizing rationale
  • State how much of the available balance this trade should use (referencing stake_amount and max_open_trades)
  • Link the invalidation level to the stoploss: "Invalidation at $3,420 with entry at $3,580 = 4.5% downside. Stoploss set at -0.05 to give breathing room."
  • Compute the risk per trade: "Risking $45 on a $1,000 wallet = 4.5% account risk per trade."
  • If the risk per trade exceeds 5% of available balance, flag it explicitly and ask the user to confirm or reduce size
  • Reference max_open_trades — if multiple positions may be open, total portfolio risk = risk per trade x max open trades

Example thesis

Setup: Funding squeeze on ETH perps, 1h timeframe.

1. Thesis statement

Long ETH/USDC:USDC on a funding squeeze — shorts are deeply underwater with funding APR at -22%, price has reclaimed the 4h EMA-21 with rising volume, targeting a 4-6% forced-unwind move over 24-48h.

2. Bull case

  • Funding APR is -22% and worsening over the last 8 hours — shorts are paying 0.0025% per hour with no relief. This is top-decile negative funding for ETH over the past 90 days.
  • Price rallied +3.8% in the last 24h and is holding above the 4h EMA-21 ($3,540). The move has follow-through: RVOL is 1.9x on the breakout session.
  • OI increased +4.2% while price rose — new shorts are entering into a rising market, adding squeeze fuel rather than draining it.

3. Bear case

  • BTC is testing the $98,000 resistance level. A rejection here historically drags ETH down 5-8% regardless of ETH-specific setups. The macro is the dominant risk.
  • The last two ETH funding squeezes in this regime (March 12, April 3) both reversed within 12h of funding hitting -25% APR. The squeeze may be closer to exhaustion than acceleration.
  • Spot exchange inflows ticked up 1.8x in the last 6h — potential distribution into the rally, not accumulation.

4. Invalidation level

Below $3,420 (the pre-breakout consolidation low). If ETH gives back the entire reclaim candle, the squeeze is not catching and shorts are right. Stoploss anchored at -0.045 from entry to cover this level plus slippage.

Time stop: if the move hasn't produced +2% within 24h, the catalyst is stale. Exit via custom_exit timeout.

5. Data check

  • price_check ETH/USDC:USDC — confirm price is still above $3,540 and the reclaim is intact
  • volume_momentum_check ETH — confirm RVOL is still > 1.5x
  • balance_check — confirm at least $150 USDC available (stake $100 + buffer)
  • alpha_scan — confirm ETH ranks in the squeeze-fuel bucket with score > 0.7
  • pair_validate ETH/USDC:USDC — confirm pair is active, check margin requirements

6. Position sizing rationale

Wallet balance: $1,200 USDC. Using stake_amount: 100 with max_open_trades: 1. Invalidation at $3,420 with expected entry near $3,560 = 3.9% downside. Stoploss at -0.045 covers the invalidation level. Risking ~$4.50 on a $1,200 wallet = 0.375% account risk. Conservative sizing — appropriate for a first deployment of this setup. Room to scale up on the next squeeze if this one validates.

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

Files

Just SKILL.md in skills/trade-thesis of Superior-Trade/superior-skills.

Open the folder on GitHubat commit 9d41db5

Compare with similar skills

Trade Thesis 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.

Trade Thesis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trade Thesis this skillSuperior-Trade/superior-skills215—~1.9kAutomated safety check: PassMIT
Trader Memory Coretradermonty/claude-trading-skills3k2 repos~4.3kAutomated safety check: PassMIT
Weekly Trading Planzhu1090093659/dsh-trading238—~2kAutomated safety check: PassCustom licence
Trading Ledgersickn33/agentic-awesome-skills47k1 repos~2.2kAutomated safety check: PassMIT
Prediction Market Strategyagiprolabs/claude-trading-skills410—~3.4kAutomated safety check: PassMIT
Academic Paper StrategistAAASS554/codex-academic-paper-skills5391 repos~2.7kAutomated safety check: PassMIT

Similar skills

  • Trader Memory Core

    tradermonty/claude-trading-skills

    Track investment theses across their lifecycle — from screening idea to closed position with postmortem.

    3k GitHub starsUsed in 2 repos~4.3k tokens
    DevOps & CloudAuto-check passed
  • Weekly Trading Plan

    zhu1090093659/dsh-trading

    制定每周交易计划:把本周复盘、统一台账持仓与资金、市场消息与公告、facts/ 与知识库、假设档案(hypothesistracking / 持仓 thesis / 宏观管道状态)合成一份下周计划,逐条过六道闸门并给出双向预案与失效条件。当用户要求「制定本周/下周交易计划」「周度作战计划」「把复盘+持仓+消息+知识库合成计划」,或周末例行生成计划时调用。

    238 GitHub stars~2k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Trading Ledger

    sickn33/agentic-awesome-skills

    A trading journal that captures the decision, not just the fill: thesis, plan, and emotion at the moment of entry, written to the user's own Notion database; reviews grade decisions, not P&L.

    47k GitHub starsUsed in 1 repo~2.2k tokens
    Business, Finance & HRAuto-check passed
  • Prediction Market Strategy

    agiprolabs/claude-trading-skills

    Venue- and market-type-agnostic strategy, sizing, and backtesting layer for binary prediction markets (Kalshi, Polymarket, ForecastEx).

    410 GitHub stars~3.4k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Academic Paper Strategist

    AAASS554/codex-academic-paper-skills

    A skill your agent uses when the user needs to plan, de-risk, or ground a software engineering / computer science undergraduate thesis from a real codebase before final writing.

    539 GitHub starsUsed in 1 repo~2.7k tokens
    EducationAuto-check passed
  • Builds a scoring-aligned outline for a mathematical modeling paper and a model selection plan with baseline, improvement and validation experiments.

    454 GitHub starsUsed in 1 repo~1.8k tokens
    EducationAuto-check passed

More from Superior-Trade/superior-skills

All 31 skills in this repo
  • Superior Trade Auth

    Superior-Trade/superior-skills

    A skill your agent uses when an agent needs to register a Superior Trade account, verify an email OTP, configure x-api-key authentication, or recover from missing or invalid credentials before using…

    215 GitHub stars~950 tokensUpdated 1 mo ago
    Auto-check passed
  • Deposit Qr

    Superior-Trade/superior-skills

    A skill your agent uses when a user needs a QR code or wallet payment URI to fund a Superior-managed EVM wallet on a specific chain before using Lighter, Polymarket, Hyperliquid, or other Superior…

    215 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • External Deposit

    Superior-Trade/superior-skills

    A skill your agent uses when a user wants to fund or bridge from an external wallet through a third-party UI such as Relay, especially when asking for MetaMask Mobile QR codes, bridge links…

    215 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Aerodrome

    Superior-Trade/superior-skills

    A skill your agent uses when creating, validating, backtesting, deploying, sizing, or troubleshooting Aerodrome/Base spot trading strategies through the Superior Trade API, especially Freqtrade…

    215 GitHub stars~2.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Polymarket

    Superior-Trade/superior-skills

    A skill your agent uses when the user wants to trade, research, or backtest Polymarket prediction markets through Superior Trade — finding markets by slug or event URL, placing a single immediate…

    215 GitHub stars~4.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Backtesting

    Superior-Trade/superior-skills

    A skill your agent uses when running, interpreting, or designing backtests on Superior Trade — anything about backtest windows, trade-count thresholds, exit-reason mix, parameter sweeps…

    215 GitHub stars~2.9k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Trade Thesis

What does Trade Thesis do?

A skill your agent uses when a user proposes a trade idea, asks "should I trade X", wants a bull/bear case, conviction check, trade plan or pre-trade analysis, or before deploying any new strategy…. Trade Thesis is an agent skill from Superior-Trade/superior-skills. Use when a user proposes a trade idea, asks "should I trade X", wants a bull/bear case, conviction check, trade plan or pre-trade analysis, or before deploying any new strategy live for the first time.

When should I use Trade Thesis?

Trade Thesis fits situations like: A user proposes a trade idea; asks should I trade X; wants a bull/bear case; conviction check.

How do I install Trade Thesis in Claude Code?

Run `npx skills add Superior-Trade/superior-skills --skill trade-thesis -a claude-code`. Or copy the skill folder (skills/trade-thesis in Superior-Trade/superior-skills) into .claude/skills/trade-thesis in your project. Claude Code loads it when a task matches its description.

How do I install Trade Thesis in Codex?

Run `npx skills add Superior-Trade/superior-skills --skill trade-thesis -a codex`. Or copy the skill folder (skills/trade-thesis in Superior-Trade/superior-skills) into .agents/skills/trade-thesis in your project. Codex loads it when a task matches its description.

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

What does Trade Thesis need to run?

SKILL.md names no scripts, command-line tools or credentials: Trade Thesis is instructions for the agent only.

Does Trade Thesis 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 Trade Thesis 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 Trade Thesis use?

Trade Thesis 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 Trade Thesis use?

About 1.9k tokens (SKILL.md is roughly 7.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 Trade Thesis?

Skills that share tags, products or a category with Trade Thesis: Trader Memory Core (tradermonty/claude-trading-skills, 3k stars), Weekly Trading Plan (zhu1090093659/dsh-trading, 238 stars), Trading Ledger (sickn33/agentic-awesome-skills, 47k stars) and Prediction Market Strategy (agiprolabs/claude-trading-skills, 410 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trade Thesis?

Superior-Trade (a GitHub organization) maintains it in Superior-Trade/superior-skills, which has 215 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on September 10, 2026.

Source: Superior-Trade/superior-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.