Communitygithub.com

austin-starks/Public-Portfolio-Challenge

Crea indicadores personalizados de datos alternativos en NexusTrade (menciones de Reddit/WSB, divulgaciones del Congreso, presentaciones de información privilegiada, flujo de noticias) e intégralos en una cartera certificada como señal de rango, inclinación o filtro.

¿Qué es Public-Portfolio-Challenge?

Este skill, diseñado para la plataforma NexusTrade, permite a los desarrolladores construir y validar indicadores basados en datos alternativos (alt-data) y conectarlos a estrategias de cartera certificadas. El proceso comienza con sesiones de cómputo guiadas (compute sessions) para construir el indicador paso a paso, verificando luego su cobertura por ticker, frescura y ausencia de lookahead bias. El skill establece reglas claras de integración: los datos densos pueden combinarse con el rango de momentum (S1), mientras que series dispersas solo sirven como inclinación (S2) o filtro de entrada/salida (S3/S4). Incluye recetas para fuentes como Reddit/WSB, divulgaciones del Congreso y formularios 4 de información privilegiada, y advierte sobre la necesidad de auditar la seguridad contra lookahead y la densidad de la serie antes de cualquier backtest. Está pensado para usarse con el MCP de NexusTrade conectado.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/austin-starks/Public-Portfolio-Challenge/tree/HEAD/skills/alt-data-indicators

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Indicadores Personalizados de Datos Alternativos

Los datos alternativos son un experimento de SEÑAL, no un experimento de estructura — solo pueden tocar la señal de rango / ponderación / filtrado, nunca la estructura de opciones (ver reglas-de-estructura-de-opciones). El titular es la referencia: los datos alternativos deben GANARSE su lugar superando (o reduciendo materialmente el riesgo de) la cartera certificada bajo las mismas puertas OOS. "El indicador es genial" no es un resultado.

Construir con sesiones de cómputo guiables (preferido)

Prefiere compute_session_start / compute_session_exec → compute_session_promote_indicator / compute_session_end para cualquier construcción de datos de varios pasos: /work persiste, observas cada paso, y todo el historial termina en UN indicador promovido. Lista y finaliza las sesiones obsoletas primero (compute_session_list); envía ejecuciones periódicas mientras se ejecuta un trabajo largo. run_compute es solo para trabajos pequeños de una sola consulta. Otras herramientas de la pila: dataset_to_indicator, build_signal_indicator, create_indicator, list_custom_indicators, collect_web_data, discover_sources, enrich_source, ingest_content, probe_url, sec_edgar, get_compute_status, cancel_compute_job.

Cada fuente recibe: construir → conteo de puntos + verificación de cobertura → auditoría de lookahead → verificación puntual de valores contra la fuente primaria → registrar. Los fallos de plataforma reciben el protocolo-de-error; después de dos fallos distintos en una fuente, detenla y pasa a la siguiente — no dejes que una tubería rota paralice la campaña.

Nunca conectes un indicador no verificado (lecciones #10/#11)

Antes de referenciar cualquier CustomIndicator en una estrategia, confirma los cuatro con list_custom_indicators + una verificación puntual de la fuente:

  1. Conteo de puntos — elimina los cuerpos de 0 puntos.
  2. Cobertura por ticker de todo el universo (los 21 nombres, no una muestra).
  3. Frescura — la fecha máxima; una señal cuyos datos se han vuelto obsoletos NO debe impulsar una cartera en vivo.
  4. Seguridad contra lookahead — ver más abajo.

La regla de la serie dispersa

Una expresión de rango/peso solo funciona con una serie que sea DENSA en todo el universo. Una serie dispersa / de cobertura parcial (por ejemplo, las compras de un político que cubren ~1 de 21 nombres) solo puede ser una inclinación o superposición, nunca una entrada de rango — y un rango construido sobre ella negociará CERO (conexión degenerada). Dilo y desprioriza; no la fuerces.

La seguridad contra lookahead no es negociable (lección #11)

Cada punto de datos alternativos está sellado con la fecha en que la información fue PÚBLICA (fecha de presentación / divulgación / publicación), NO la fecha de la operación/evento. Las operaciones del Congreso tienen un rezago de la Ley STOCK de hasta ~45 días — la señal debe incorporar ese rezago. Audita explícitamente por indicador antes de que cualquier backtest lo utilice. Cuando sea posible, cruza los valores con una segunda construcción generada de forma independiente (una serie de conteo de WSB se verificó de esta manera — dos construcciones independientes coincidieron exactamente). Un raspado retroactivo de publicaciones históricas está bien; un modelo de sentimiento aplicado retroactivamente está bien (anótalo como una advertencia); usar supervivientes de eliminación es una advertencia a anotar.

Los límites de cobertura de datos acotan la ventana de certificación

Verifica primero el mes máximo del lago de origen y trata el final de la cobertura de la señal como una restricción estricta en las ventanas de certificación y la capacidad de implementación. El motor de walk-forward recorta el calendario de pliegues a la cobertura del indicador, por lo que las comparaciones de certificación deben estar alineadas con el calendario — ejecuta un control base en el calendario recortado de la variante (ver walk-forward-oos).

Formas de integración (elige según la cobertura)

#IntegraciónDóndeCobertura necesaria
S1Mezclar en el rango — señal alternativa combinada con ROC de momentum como weightIndicator / métrica SelectToprangoamplia (mayoría de 21)
S2Inclinación — rangos de momentum; datos alternativos sobre/sub-ponderan nombres con señal recientepesoparcial OK
S3Filtro de entrada — solo abrir un nombre si la señal alternativa se disparó en los últimos N días / por encima de Xcondiciónparcial OK (¡revisar el arranque en frío con auditoría-de-amplitud!)
S4Superposición de confirmación — la señal alternativa relaja/ajusta una compuerta existente (ej. VIX)condicióncualquiera

El momentum sigue siendo primario, el ruido es una inclinación: un rango basado solo en atención ha perdido estrepitosamente; una inclinación de atención con amortiguación logarítmica sobre el momentum ha ganado. Forma ancla S1 probada: weightIndicator = Multiply(ROC63, Plus(1, Log(base 10, Plus(1, IndicatorSimpleMovingAverage(21d, CustomIndicator))))). Ejes de cuadrícula que vale la pena variar: ventana SMA (10/21/42), fuerza de inclinación (log vs lineal acotada).

La integración es construida a mano, no barrida (CustomIndicator no es un tipo barrible) — construye una cuadrícula de variantes mediante create_portfolio_variant (copia profunda de la base + parche JSON-Pointer, primero dry_run), etiqueta manual (ámbar), y prueba cada una con un backtest de 12 meses y $25k antes de gastar en pliegues (operaciones cero/casi cero ⇒ el rango/filtro no está resolviendo → arreglar o descartar). Ver sweep-reoptimization.

Recetas de fuentes

  • references/reddit-wsb-recipe.md — la tubería probada de conteo de menciones del lago Ártico de Reddit.
  • references/congressional-disclosures.md — tubería de PTR del Secretario de la Cámara (agregado de todo el Congreso).
  • references/other-sources.md — formulario 4 de información privilegiada, flujo de noticias, atención; y alcance de sec_edgar.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

austin-starks/Public-Portfolio-Challenge

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.

austin-starks/Public-Portfolio-Challenge

The \"loudly declare\" protocol for platform, engine, or data bugs during a NexusTrade certification campaign — bugs are a first-class deliverable, not something to route around. Use whenever a NexusTrade tool errors, hangs, or returns numbers that contradict the config; whenever you're tempted to write \"probably an engine quirk\"; or when a discovered bug invalidates prior backtests and results must be quarantined. Includes the bug hand-off doc template (see references/BUG_TEMPLATE.md).

austin-starks/Public-Portfolio-Challenge

The GATED deploy + cleanup flow for a NexusTrade live book — clone the finalist, preview a delta reconcile, stage UNAPPROVED orders, verify fills. Use ONLY after the human explicitly says \"deploy + clean up\" and names a finalist. Covers the clone-before-reconcile ordering, the single-tick reconcile expectation, stale-pending-order hygiene, the signal-freshness gate, and why you can never approve orders yourself. Nothing here runs during certification.

austin-starks/Public-Portfolio-Challenge

The mandatory pre-flight contract checks (Stage S0) that must pass before trusting NexusTrade's certification engine for any strategy work. Use at the start of a bakeoff or certification campaign to prove the walk-forward engine runs end-to-end, windows don't leak, fold winners persist, and the engine doesn't fabricate values for dead/not-yet-listed names. Each check has a STOP-and-report failure mode; these runs do NOT count toward any certification minimum.

austin-starks/Public-Portfolio-Challenge

The single-touch lockbox — a final anti-overfitting holdout run once, after design freeze, on a window held out from every fold, sweep, and search. Use when finalizing a bakeoff winner before deploy, setting up the A/B/C baselines as OOS bars, or running the S1.5 gate-coherence auto-relax. Covers why looking at the lockbox twice burns it, the lockbox pass conditions, and the three baselines. The lockbox is distinct from the walk-forward OOS folds.

austin-starks/Public-Portfolio-Challenge

The hard structural constraints for the Public Portfolio Challenge momentum-LEAP options book — the spread-shape rule, the take-profit convexity-cap footgun, the affordability ladder, and the known losers not to re-test. Use whenever building or auditing an options strategy structure, checking spread-shape compliance before a certification, choosing DTE/strike rungs, or deciding whether a proposed structure change is even allowed. A violation is an automatic certification FAIL.

austin-starks/Public-Portfolio-Challenge

Orchestrate an out-of-sample certification of a NexusTrade trading strategy or live book — the master discipline behind the Public Portfolio Challenge. Use whenever you must decide PASS/FAIL on whether a portfolio holds up out of sample before deploying real money, replaying the Episode 10 runbooks, or running a \"certify my book\" / \"prove it out of sample\" / \"re-certify the fix\" task with the NexusTrade MCP connected. Pulls in walk-forward-oos, breadth-audit, sweep-reoptimization, options-structure-rules, bug-protocol, and deploy-gate.

austin-starks/Public-Portfolio-Challenge

The single entry point that executes a Public Portfolio Challenge episode or addendum runbook end-to-end, delegating each stage to the functional skills. Use when asked to run/execute/replay Episode 10, its bakeoff, or its addendum with the NexusTrade MCP connected. Reads the target runbook, pins its real artifacts (IDs, the incumbent bar), sequences the stages, and stops at the gated deploy. It orchestrates; the functional skills do the work.

austin-starks/Public-Portfolio-Challenge

Run a multi-family strategy bakeoff — the SEARCH→CERTIFY funnel that screens many candidate mechanisms down to a certified deploy winner without letting the cheap search layer issue a verdict. Use when replaying the Episode 10 bakeoff, when exploring several distinct strategy families before certifying, when deciding whether \"no deployable winner\" is even a legal conclusion, or when building the per-family certification ledger. Enforces verdict-integrity: only certification can end a campaign.

austin-starks/Public-Portfolio-Challenge

Re-optimize a NexusTrade strategy with a walk-forward SWEEP and label parameter provenance — the discipline that prevents deploying inherited knobs. Use whenever a structural change (sizing, rung depth, universe membership, DTE family, adding a rank signal) forces a re-sweep, when authoring gene_intents from get_sweep_surface, when choosing sweep over GA for a deploy cert, or when selecting the cross-fold-robust winner instead of the per-fold argmax. Invoke with the NexusTrade MCP connected.

austin-starks/Public-Portfolio-Challenge

Run and read a NexusTrade walk-forward out-of-sample study — the certification engine behind the Public Portfolio Challenge. Use when certifying a fixed portfolio (backtest_only) or re-optimizing one (sweep), when setting fold_count / anchored / validation / embargo params, when monitoring a run_walk_forward_study to completion, when reading per-fold OOS returns/Sortino/drawdown, or when a variant's fold calendar needs calendar-alignment against a base control. Invoke with the NexusTrade MCP connected.

Skills relacionados