f1-data-platform

Stars0

Forks0

UpdatedMarch 25, 2026 at 08:52

Use when working on connectors, ingestion jobs, Bronze/Silver/Gold storage, schema migrations, lineage, entity mapping, or data quality for F1 and Polymarket data.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

YoungseokOh

YoungseokOh/f1-polymarket-lab

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Data ScientistsComputer and Mathematical Occupations·SOC 15-2051

SKILL.md

readonly

name	f1-data-platform
description	Use when working on connectors, ingestion jobs, Bronze/Silver/Gold storage, schema migrations, lineage, entity mapping, or data quality for F1 and Polymarket data.

f1-data-platform

Use this skill for storage and ingestion changes.

Start here

Read README.md, docs/data-dictionary/core-tables.md, and db/ddl/schema-overview.md.
Inspect the current SQLAlchemy models, Alembic migrations, worker pipeline, and connector code before proposing changes.

Workflow

Confirm the source contract from official docs before hardcoding endpoints, parameters, or websocket payload assumptions.
Keep ingestion split by concern: discovery, hydrate, normalize, reconcile, and quality checks.
Preserve idempotency with cursor state, fetch logs, and object manifests.
Store raw source payloads in Bronze as close to source format as practical.
Keep Silver typed and normalized; do not silently coerce whole records to strings.
When schema changes, update SQLAlchemy models, Alembic, docs, and tests together.
Preserve Polymarket official API and documented websocket usage only; do not scrape the DOM.

Polymarket market discovery

주 이벤트 마켓(레이스 우승자, 폴 포지션 등 고유동성)은 Gamma API의 /markets 또는 /events 엔드포인트로는 조회되지 않을 수 있다.
항상 https://polymarket.com/sports/f1/props 웹페이지를 직접 조회하여 열린 마켓 전체를 먼저 파악하라.
이벤트 슬러그 패턴 예시: f1-japanese-grand-prix-winner-2026-03-29, f1-japanese-grand-prix-driver-pole-position-2026-03-28
슬러그를 확인한 뒤 Gamma API GET /markets?slug=<slug> 또는 GET /events?slug=<slug>로 토큰 ID와 가격을 조회한다.

Validation

uv run ruff check .
uv run mypy apps py
uv run pytest
uv run alembic upgrade head when models or migrations change

More from this repository

same repository

f1-weekend-ops

YoungseokOh/f1-polymarket-lab

Use when working on weekend operations, the queued-job worker, ops-calendar authority, per-GP CLI commands, model promotion gates, paper trading, or operator-assisted live trading for the F1 prediction-market stack.

2026-07-020

research-reporting

YoungseokOh/f1-polymarket-lab

Use when producing EDA summaries, analyst notes, model explanations, data lineage summaries, or concise research reports from structured project data.

2026-03-210

change-finalizer

YoungseokOh/f1-polymarket-lab

Use when preparing a change for handoff, review, release notes, or commit drafting, especially when validation coverage and commit message quality matter.

2026-03-180

f1-modeling-backtest

YoungseokOh/f1-polymarket-lab

Use when building features, snapshots, experiments, models, calibration, evaluation, or backtests for the F1 prediction-market research stack.

2026-03-180

f1-web-api-lab

YoungseokOh/f1-polymarket-lab

Use when changing the FastAPI service, Pydantic schemas, TypeScript contracts, Next.js dashboard, or analyst-facing exploration workflows.

2026-03-180

name	f1-data-platform
description	Use when working on connectors, ingestion jobs, Bronze/Silver/Gold storage, schema migrations, lineage, entity mapping, or data quality for F1 and Polymarket data.

f1-data-platform

Use this skill for storage and ingestion changes.

Start here

Read README.md, docs/data-dictionary/core-tables.md, and db/ddl/schema-overview.md.
Inspect the current SQLAlchemy models, Alembic migrations, worker pipeline, and connector code before proposing changes.

Workflow

Confirm the source contract from official docs before hardcoding endpoints, parameters, or websocket payload assumptions.
Keep ingestion split by concern: discovery, hydrate, normalize, reconcile, and quality checks.
Preserve idempotency with cursor state, fetch logs, and object manifests.
Store raw source payloads in Bronze as close to source format as practical.
Keep Silver typed and normalized; do not silently coerce whole records to strings.
When schema changes, update SQLAlchemy models, Alembic, docs, and tests together.
Preserve Polymarket official API and documented websocket usage only; do not scrape the DOM.

Polymarket market discovery

주 이벤트 마켓(레이스 우승자, 폴 포지션 등 고유동성)은 Gamma API의 /markets 또는 /events 엔드포인트로는 조회되지 않을 수 있다.
항상 https://polymarket.com/sports/f1/props 웹페이지를 직접 조회하여 열린 마켓 전체를 먼저 파악하라.
이벤트 슬러그 패턴 예시: f1-japanese-grand-prix-winner-2026-03-29, f1-japanese-grand-prix-driver-pole-position-2026-03-28
슬러그를 확인한 뒤 Gamma API GET /markets?slug=<slug> 또는 GET /events?slug=<slug>로 토큰 ID와 가격을 조회한다.

Validation

uv run ruff check .
uv run mypy apps py
uv run pytest
uv run alembic upgrade head when models or migrations change