breadth-audit
Skill82 starsChanged 3 months agoMITView on GitHub
Measure a NexusTrade options book's TRUE participation at a fixed cold-start capital base, defeating the compounded-NAV breadth illusion. Use whenever a book's headline \"holds N/21 names\" needs validating, when a live book collapses to a single name (the OSCR trap), when checking whether a SelectTop / per-name-allocation / total-budget change degraded simultaneous participation, or when a certification needs a breadth gate. Uses audit_backtest_breadth at held-fixed $25k.
In this repository23 other files it gives its agents.
- skills/alt-data-indicators/AGENTS.mdAGENTS.md
- skills/breadth-audit/AGENTS.mdAGENTS.md
- skills/bug-protocol/AGENTS.mdAGENTS.md
- skills/deploy-gate/AGENTS.mdAGENTS.md
- skills/engine-sanity/AGENTS.mdAGENTS.md
- skills/lockbox-holdout/AGENTS.mdAGENTS.md
- skills/options-structure-rules/AGENTS.mdAGENTS.md
- skills/portfolio-certification/AGENTS.mdAGENTS.md
- skills/run-episode/AGENTS.mdAGENTS.md
- skills/strategy-bakeoff/AGENTS.mdAGENTS.md
- skills/sweep-reoptimization/AGENTS.mdAGENTS.md
- skills/walk-forward-oos/AGENTS.mdAGENTS.md
- alt-data-indicatorsSkill
- bug-protocolSkill
- deploy-gateSkill
- engine-sanitySkill
- lockbox-holdoutSkill
- options-structure-rulesSkill
- portfolio-certificationSkill
- run-episodeSkill
- strategy-bakeoffSkill
- sweep-reoptimizationSkill
- walk-forward-oosSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 0 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 36
Use mcp__nexustrade__audit_backtest_breadth at a held-fixed capital base (don't let the run compound).
- Very specific: line 44
Run it on the 12-month window and separately on the full cycle.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Fixed-Capital Breadth Audit
Breadth is measured at FIXED $25k, never inferred from a compounded backtest. This is the whole point of the participation lesson: a headline like "19/21 names" is almost always an artifact.
The breadth illusion
"19/21 names" on a full-cycle run means nothing — it is NAV compounding + distinct-names-over-time.
A book that compounds to $300k notional will touch many names across the run while, at cold-start
$25k, it funds only the cheapest one or two and strands the rest. The live proof of this: a certified
book that "held 19/21" deployed live and only bought OSCR, because at $25k a 5%-per-name budget
($1,200–1,450) only ever afforded the cheapest underlying's LEAP.
Root cause pattern: at low NAV a per-name budget affords only the cheapest name's contract, and the sizing policy strands the budget on unaffordable top-weighted names instead of flowing it to the next affordable one → the book collapses to one name.
How to measure
Use mcp__nexustrade__audit_backtest_breadth at a held-fixed capital base (don't let the run
compound). Capture, per the current config:
- simultaneous distinct names held (the headline number — lead with it),
participation,distinctNamesFilled,- per-name
cannotAffordcounts.
Run it on the 12-month window and separately on the full cycle. For a live collapse, also pull
query_portfolio_events (OptionResolutionAttempt) to see the "Cannot afford even 1 contract"
rejections and which names cleared — that is the live evidence.
SelectTop truncates BEFORE affordability
SelectTop N truncates the candidate pool before the affordability backfill runs. A narrow top-N
re-creates the single-name collapse — which is exactly why the certified incumbent is top-21 (21 of
21 never truncates, so the rank ORDER only decides funding priority, never membership). If you narrow
SelectTop, re-run this audit.
The breadth gate (in certification)
A variant must not degrade cold-start participation vs the incumbent. Concretely for a
participation-repair campaign: simultaneous distinct names ≥ target, participation ≥ ~0.5,
cannotAfford sharply down vs the before state. A config that certifies but still funds one name
is a non-answer — breadth without gain and gain without breadth both FAIL a participation attempt.
Entry filters (S3-style alt-data filters) are the main breadth risk — the filtered subset must stay affordable and broad, so always re-check cold-start breadth after adding one.
Levers that move breadth (all keep outright-calls-only)
- Raise per-name allocation — funds ≥1 contract on more names, but fewer simultaneous slots.
- Affordability-aware backfill / guarantee-1-contract-to-top-N — the most direct low-NAV lever;
verify the engine actually backfills (it has historically not). Note: the backfill loop is also
where the
totalBudgetover-deployment bug lived — see bug-protocol. - Rung depth / count — deeper OTM cheaper rungs let premium names enter; watch convexity erosion.
- Total budget — more slots fillable; interacts with per-name alloc.
Changing any sizing lever is a structural change → re-sweep, don't inherit knobs (sweep-reoptimization).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

