futures-trading

futures-trading is a skill for Claude Code from mahmoud20138/Tradecraft. It costs 99 tokens per session (923 once invoked), scanned A, original, MIT.

A reference for futures trading, where contracts set an agreement to buy or sell an asset at a later date. It covers expiry, rollover, margin, basis, contango, backwardation, and common commodity, index, and interest-rate contracts.

In plain words
What is it for?
Working with contracts such as S&P 500, Nasdaq, crude oil, gold, and 10-year Treasury futures, including expiry planning, rollovers, margin, and term-structure analysis.
Why use it?
It explains the contract mechanics and price relationships that affect futures positions and their risks.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: positional $N argument.

Part of the tradecraft plugin — 58 skills shipped together

Good fit Working with contracts such as S&P 500, Nasdaq, crude oil, gold, and 10-year Treasury futures, including expiry planning, rollovers, margin, and term-structure analysis.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/mahmoud20138/tradecraft/futures-trading
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add mahmoud20138/Tradecraft --skill futures-trading
Clone the repo
git clone --depth 1 https://github.com/mahmoud20138/Tradecraft

Made for: Claude Code.

Or install tradecraft, the plugin that ships this one along with the rest of its 58 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for futures-trading

README.md
[![agentmods](https://agentmods.dev/badge/skills/mahmoud20138/tradecraft/futures-trading/github.svg)](https://agentmods.dev/skills/mahmoud20138/tradecraft/futures-trading)
Your own site
<a href="https://agentmods.dev/skills/mahmoud20138/tradecraft/futures-trading"><img src="https://agentmods.dev/badge/skills/mahmoud20138/tradecraft/futures-trading/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for futures-trading

Your own site · 80×15
<a href="https://agentmods.dev/skills/mahmoud20138/tradecraft/futures-trading"><img src="https://agentmods.dev/badge/skills/mahmoud20138/tradecraft/futures-trading.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 99 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 923 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00099 $0.00923
Opus 5 $0.00049 $0.00462
Sonnet 5 $0.00020 $0.00185
Haiku 4.5 $0.00010 $0.00092

Measured 12d ago against content hash eee06879c1b1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

futures-trading scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/tradecraft/skills/futures-trading/SKILL.md · 94 lines

How it starts

The opening of the file, as written. The whole thing — 94 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Skill: Futures Trading | Domain: trading | Category: asset-class | Level: intermediate Tags: trading, asset-class, futures, contracts, rollover, contango

Futures Trading — Asset Class Reference

Contract Mechanics

  • Expiry: Futures expire on a fixed date (quarterly for index/rates, monthly for commodities)
  • Rollover: Roll to next contract before expiry (typically 5–10 days before)
  • Basis: Difference between futures price and spot price
  • Contango: Futures > Spot (normal for commodities with storage costs)
  • Backwardation: Futures < Spot (supply squeeze signal for commodities)

Key Futures Instruments

Contract Exchange Tick Size Session (UTC)
ES (S&P 500) CME $12.50 23:00–22:00
NQ (Nasdaq) CME $5.00 23:00–22:00
CL (Crude Oil) NYMEX $10.00 00:00–23:00
GC (Gold) COMEX $10.00 23:00–22:00
ZN (10Y Note) CBOT $15.625 00:00–22:00

Contango/Backwardation Signal

def term_structure_signal(spot: float, front_month: float, next_month: float) -> dict:
    basis_1 = front_month - spot
    basis_2 = next_month - front_month
    structure = ("CONTANGO" if basis_1 > 0 and basis_2 > 0 else
                 "BACKWARDATION" if basis_1 < 0 and basis_2 < 0 else "MIXED")
    return {
        "structure": structure,
        "basis_front": round(basis_1, 2),
        "basis_next": round(basis_2, 2),
        "signal": {
            "CONTANGO": "Normal — no supply shock. Bearish medium-term for commodities.",
            "BACKWARDATION": "Supply squeeze or high demand. Bullish near-term.",
            "MIXED": "Transitioning — watch for structure shift.",
        }.get(structure),
    }

Oil & Gold (Your Instruments)

# Exness CFD equivalents of futures
OIL_CFD  = "USOILm"   # Tracks WTI crude front-month
GOLD_CFD = "XAUUSDm"  # Tracks COMEX gold spot/front-month

# Key oil fundamentals
OIL_DRIVERS = ["EIA inventory (Wed 14:30 UTC)", "OPEC decisions",
                "USD strength (inverse)", "geopolitical risk premium"]
GOLD_DRIVERS = ["Real yields (inverse)", "USD index (inverse)",
                "Risk sentiment", "Central bank buying"]

Read the full file on GitHub · 94 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 94 lines · 99 tokens per session scan A eee06879c1b1

Subscribe to this mod's changes

futures-trading is a skill published in the GitHub repository mahmoud20138/Tradecraft (15 stars, last pushed 4mo ago), licensed MIT. It adds 99 tokens to every session and 923 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.