sb-dev/openquant / .agents/skills/ml4t-define-universe
ml4t-define-universe
VerifiedDefine versioned watchlists and point-in-time research universes while preserving identity, membership history and delistings.
Define the research universe
Read OQ-02 §1.1 and §3 in docs/specs/. Distinguish an operator-selected watchlist from a historical investable universe. A fixed current watchlist is valid for its stated task but does not establish an unbiased historical market sample.
Define membership
- Use stable instrument IDs. Keep ticker, exchange, share class and company-ID mappings with effective dates; symbols may change or be reused.
- Freeze the watchlist version when a cycle starts. Edits change future cycles and never erase older members or outcomes.
- If claiming a historical universe, use membership and eligibility information available at each decision time. Retain delisted, acquired and failed securities.
- Predeclare liquidity/history/price filters and rebalance timing. Sort observations and apply availability cutoffs before computing trailing metrics. Do not use future membership or current financial snapshots.
- Record coverage exclusions and unknown historical search/selection. Missing data must not silently remove difficult or unsuccessful instruments.
Handle exits honestly
Use documented corporate-action treatment and actual proceeds where supported. Do not assign fixed bankruptcy, acquisition or going-private returns by category. Missing terminal values produce an explicit gap or a declared conservative bound with sensitivity evidence, not fabricated cash flows.
Verify
Exercise additions/removals, ticker changes/reuse, multiple share classes, delisting, incomplete history and future membership contamination. Show that past cycle hashes and results survive watchlist edits. Keep prospective watchlist evidence separate from claims about survivorship-free historical selection.
Adapted from ML4T skills at revision 691857537a0c8befc11dc2f2ad7a458b7c7e801c. Original Apache-2.0 licence and attribution remain in .claude/third-party/ml4t/skills. OpenQuant adaptation: 2026-11-05.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |