Agent skill · data analytics · machina-sports
fastf1
Formula 1 data — race schedules, results, lap timing, driver and team info. Powered by the FastF1 library. Covers F1 sessions, qualifying, practice, race results, sector times, tire strategy. Use when: user asks about F1 race results, qualifying, lap times, driver stats, team info, the F1 calendar, or Formula 1 data. Don't use when: user asks about other motorsports (MotoGP, NASCAR, IndyCar, WEC, Formula E). Don't use for F1 betting odds or predictions — use kalshi or polymarket instead. Don't use for F1 news articles — use sports-news instead.
Why this skill is useful
Provides specific commands and workflows for retrieving and analyzing Formula 1 data that the AI wouldn't generate on its own.
What it needs
Requires sports-skills installed locally. About 4k tokens when loaded. Last updated 2026-08-06. 201 stars on the source repository.
What this skill does
FastF1 — Formula 1 Data Before writing queries, consult references/api-reference.md for endpoints, ID conventions, and data shapes. Quick Start Prefer the CLI — it avoids Python import path issues: Python SDK (alternative): CRITICAL: Before Any Query CRITICAL: Before calling any data endpoint, verify: Year is derived from the system prompt's currentDate — never hardcoded. In January or February, use year = currentyear - 1 (pre-season; the new F1 season has not started yet). Choosing the Year Derive the current year from the system prompt's date (e.g., currentDate: 2026-02-16 → current year is 2026). If the user specifies a year, use it as-is. If the user says "latest", "recent", "last season", or doesn't specify: The F1 season runs roughly March–December. If the current month is January or February, use year = currentyear - 1. From March onward, use the current year. Workflows Race Weekend Analysis 1. getraceschedule --year=<year> — find the event name and date 2. getraceresults --year=<year> --event=<name> — final classification (positions, times, points) 3. getlapdata --year=<year> --event=<name> --sessiontype=R — lap-by-lap pace analysis 4. gettireanalysis --year=<year> --event=<name> — strategy breakdown (compounds, stint lengths, degradation) Driver/Team Comparison 1. getchampionshipstandings --year=<year> — championship context (points, wins, podiums) 2. getteamcomparison --year=<year> --team1=<t1> --team2=<t2> OR getdrivercomparison --year=<year> --driver1=<d1> --driver2=<d2> 3. getseasonstats --year=<year> — aggregate performance (fastest laps, top speeds) Season Overview 1. getraceschedule --year=<year> — full calendar with dates and circuits 2. getchampionshipstandings --year=<year> — driver and constructor standings 3. getseasonstats --year=<year> — season-wide fastest laps, top speeds, points leaders 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills machina-sports/fastf1