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,
By machina-sports · 401 installs
npx skills add machina-sports/sports-skills --skill fastf1
Source repository · Upstream listing
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 = current year 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 = current year 1 . From March onward, use the current year.
Workflows
Race Weekend Analysis
1. get race schedule year=<year — find the event name and date
2. get race results year=<year event=<name — final classification (positions, times, points)
3. get lap data year=<year event=<name session type=R — lap by lap pace analysis
4. get tire analysis year=<year event=<name — strategy breakdown (compounds, stint lengths, degradation)
Driver/Team Comparison
1. get championship standings year=<year — championship context (points, wins, podiums)
2. get team comparison year=<year team1=<t1 team2=<t2 OR get driver comparison year=<year driver1=<d1 driver2=<d2
3. get season stats year=<year — aggregate performance (fastest laps, top speeds)
Season Overview
1. get race schedule year=<year — full calendar with dates and circuits
2. get championship standings year=<year — driver and constructor standings
3. get season stats year=<year — season wide fastest laps, top speeds, points leaders
4. get driver info year=<year — current grid (driver numbers, teams, nationalities)
Commands
Command Description
get race schedule Full season calendar with dates and circuits
get race results Final race classification (positions, times, points)
get session data Raw session info (Q, FP1, FP2, FP3, R)
get driver info Driver details from the grid
get team info Team info with driver lineup
get lap data Lap by lap timing with sectors and tire data
get pit stops Pit stop durations and team averages
get speed data Speed trap and intermediate speed data
get championship standings Driver and constructor championship standings
get season stats Aggregate season performance
get team comparison Team head to head: qualifying, race pace, sectors
get driver comparison Driver head to head: qualifying H2H, race H2H, pace delta
get tire analysis Tire strategy, stint lengths, degradation rates
See references/api reference.md for full parameter lists and return shapes.
Examples
Example 1: F1 calendar
User says: "Show me the F1 calendar"
Actions:
1. Derive year from currentDate
2. Call get race schedule(year=<derived year )
Result: Full calendar with event names, dates, and circuits
Example 2: Driver race performance
User says: "How did Verstappen do at Monza?"
Actions:
1. Derive year from currentDate (or from context)
2. Call get race results(year=<year , event="Monza") for final classification
3. Call get lap data(year=<year , event="Monza", session type="R", driver="VER") for lap times
Result: Finishing position, gap to leader, fastest lap, and tire strategy
Example 3: Latest results queried in pre season
User says: "What were the latest F1 results?" (asked in February 2026)
Actions:
1. Current month is February → season not yet started → use year = 2025
2. Call get race schedule(year=2025) to find the last event of that season
3. Call get race results(year=2025, event=<last event ) for the final race results
Result: Results of the final 2025 race
Commands that DO NOT exist — never call these
~~ get qualifying ~~ / ~~ get practice ~~ — does not exist. Use get session data with session type="Q" for qualifying or session type="FP1" / "FP2" / "FP3" for practice.
~~ get standings ~~ — does not exist. Use get championship standings instead.
~~ get results ~~ — does not exist. Use get race results instead.
~~ get calendar ~~ — does not exist. Use get race schedule instead.
If a command is not listed in the Commands table above, it does not exist.
Troubleshooting
Error: Event name not found
Cause: Event name spelling does not match FastF1's internal naming
Solution: Call get race schedule(year=<year ) first to get the exact event names, then retry with the correct name
Error: Session data is empty
Cause: The session has not happened yet
Solution: FastF1 only returns data for completed sessions. Check get race schedule for when the session is scheduled
Error: get race results returns no fastest lap time
Cause: Some races do not include fastest lap data in the results endpoint
Solution: Use get lap data(session type="R") and find the minimum lap time across all drivers
Error: Querying the current year in January or February returns no data
Cause: The new F1 season has not started yet
Solution: Use year = current year 1 for any pre March query; do not query the current year before March