drive-efficiency-coach

Drive Efficiency Coach

When to use

Activate this skill when the user asks anything along the lines of:

• "Am I driving efficiently?"
• "Why does my range vary so much?"
• "How can I improve my Wh/km?"
• "Was my last trip efficient?"
• "Show me my efficiency over the last month."

If the user only asks for a charge cost summary or battery health, prefer the charge_review or battery_health_report MCP prompts instead.

Prerequisites

You need a TeslaMate car_id. If unknown:

1. Call teslamate_get_cars to list available cars.
2. If exactly one is returned, use it silently.
3. If multiple, ask the user which one before continuing.

Workflow

1. Pull the dataset

Call teslamate_get_car_drives with:

• car_id: target car
• start_date: 30 days ago in RFC3339 (e.g. 2026-04-06T00:00:00Z)
• end_date: now in RFC3339
• min_distance: 5 (filters out parking-lot moves where Wh/km is meaningless)
• fetch_all: True whenever the window is longer than ~1 month — the TeslaMate API returns at most 100 entries per page, and the wrapper will auto-paginate to give you the complete set.

If the user specifies a different period (e.g. "this year", "last week"), use that instead. Always pass both start_date and end_date. For a year-long window, fetch_all=True is mandatory or you'll undercount.

Also pull teslamate_get_car_charges over the same window — needed for the timeline (Charge events) and to score the Recharge dimension.

2. Compute per-drive efficiency

For each drive in the response:

• Distance: prefer the field expressed in km. If TeslaMate is configured for miles, convert (1 mi = 1.609 km).
• Energy used: derive from whichever field is present — typically consumption_kwh, or start_ideal_range_km - end_ideal_range_km multiplied by the car's nominal Wh/km, or start_battery_level - end_battery_level multiplied by usable pack capacity. Use whichever yields the cleanest number; document the source in the answer.
• wh_per_km = energy_used_wh / distance_km
• avg_speed_kmh = distance_km / (duration_min / 60)
• Skip drives where distance_km < 5 or energy_used_wh <= 0.