Individual skill
cot-contrarian-detector
Detect crowded speculative positioning in CFTC futures markets (COT report analysis) to find contrarian setups using Jason Shapiro's methodology. Screens large-speculator ("non-commercial") net positioning across 65 futures markets (indices, rates, FX, metals, energy, crypto) via the FMP Commitment of Traders API, computes a 3-year and 26-week COT Index per market, and classifies extremes as CROWDED_LONG / CROWDED_SHORT. Use when the user asks about COT report analysis, crowded positioning, "who is trapped", speculative positioning extremes, contrarian futures setups, or wants to run Jason Shapiro-style analysis. This skill automates crowding DETECTION only (step 1 of 5) — it does not generate trade signals by itself.
skills/cot-contrarian-detector/SKILL.md
Source commit 62725813263394cdd1068d9c8ae29b96d6fa3910
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 9, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 3,780
- Repository last updated
- Nov 12, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 8,653 bytesSKILL.mdcore · 8,653 bytesreferences/cot-index-calculation.mddoc · 7,855 bytesreferences/output-contract.mddoc · 3,583 bytesreferences/shapiro-methodology.mddoc · 7,666 bytesrequirements.txtdoc · 128 bytesscripts/cot_index.pyruns · 3,556 bytesscripts/fmp_client.pyruns · 20,040 bytesscripts/screen_cot_crowding.pyruns · 25,906 bytesscripts/tests/test_cot_index.pyruns · 6,569 bytesscripts/tests/test_cot_provenance.pyruns · 11,141 bytesscripts/tests/test_fmp_client_contract.pyruns · 4,570 bytesscripts/tests/test_screen_cot_crowding.pyruns · 27,753 bytes
Read excerpt
# COT Contrarian Detector
## Overview
Implements step 1 of Jason Shapiro's COT (Commitment of Traders) contrarian
process: detect when large speculators are crowded into one side of a futures
market. Crowded positioning is a *precondition* for a contrarian trade, not a
trade signal — a market only becomes tradable once crowding is confirmed by a
news failure and price-action reversal (steps 2-3), which this skill guides
the user through manually.
**Core thesis (Shapiro):** Large speculators (hedge funds, CTAs, momentum
traders) tend to be maximally positioned at trend exhaustion, not trend
inception. When they are already crowded onto one side, the next big move is