Garmin Skill
Chat with your Garmin Connect data using AI. Ask about your runs, rides, swims, training load, VO2 Max, heart rate zones, and performance trends. Powered by Transition, which syncs with Garmin Connect to give AI agents access to your training data.
Setup
- 1. Download Transition and connect your Garmin account
- Go to Settings > API Keys and tap Generate New Key
- Set the environment variable:
CODEBLOCK0
No Auth Required
Workout of the Day
Generate a random structured workout — no account needed.
CODEBLOCK1
Parameters:
- -
sport — run, bike, swim, or strength (default: run) - INLINECODE6 — minutes, 10-300 (default:
45)
Authenticated Endpoints
Base URL: https://api.transition.fun
Auth: Pass X-API-Key header on every request.
AI Coach Chat
Ask questions about your Garmin data. The AI coach has full context on your activities, training load, and performance.
CODEBLOCK2
Example questions:
- - "What was my longest run this week?"
- "How is my VO2 Max trending?"
- "Am I overtraining based on my recent Garmin data?"
- "Compare my cycling power this month vs last month"
- "What does my heart rate data say about my fitness?"
Get Workouts
Retrieve scheduled workouts for a date range.
CODEBLOCK3
Parameters:
- -
start — Start date (YYYY-MM-DD, required) - INLINECODE11 — End date (YYYY-MM-DD, required)
- Maximum range between
start and end is 90 days.
Performance Management Chart (PMC)
Get CTL (fitness), ATL (fatigue), and TSB (form) calculated from your Garmin activities.
CODEBLOCK4
Performance Stats
Get FTP, threshold paces, heart rate zones, and other metrics derived from your Garmin data.
CODEBLOCK5
Athlete Profile
CODEBLOCK6
Chat History
CODEBLOCK7
Push Workout to Garmin
Send a scheduled workout directly to your Garmin device.
CODEBLOCK8
Rate Limits
| Tier | Read Endpoints | AI Endpoints |
|---|
| Free | 100/day | 3/day |
| Paid |
10,000/day | 100/day |
Tips for Agents
- 1. Use coach chat as the primary interface. It has full context on the user's Garmin activities, training load, and performance — just ask natural questions.
- 2. Check fatigue before recommending hard workouts. Call
GET /api/v1/performance/pmc and look at TSB. If TSB is below -20, the athlete is fatigued.
- 3. Use the free WOD endpoint for quick workouts. No auth needed — great for users who just want a workout suggestion.
- 4. Date format is always YYYY-MM-DD for all date parameters.
Garmin 技能
使用AI与您的Garmin Connect数据对话。询问您的跑步、骑行、游泳、训练负荷、最大摄氧量、心率区间和表现趋势。由Transition提供支持，该应用与Garmin Connect同步，让AI代理能够访问您的训练数据。
设置
- 1. 下载Transition并连接您的Garmin账户
- 前往设置 > API密钥，点击生成新密钥
- 设置环境变量：
bash
export TRANSITIONAPIKEY=trlivexxxxxxxxxxxxxxxxxxxxx
无需认证
每日训练
生成随机结构化训练——无需账户。
bash
curl https://api.transition.fun/api/v1/wod?sport=run&duration=45
参数：
- - sport — run（跑步）、bike（骑行）、swim（游泳）或strength（力量）（默认：run）
- duration — 分钟，10-300（默认：45）
需要认证的端点
基础URL： https://api.transition.fun
认证： 每次请求需传递X-API-Key标头。
AI教练对话
询问关于您Garmin数据的问题。AI教练拥有您活动、训练负荷和表现的完整上下文。
bash
curl -X POST -H X-API-Key: $TRANSITIONAPIKEY \
-H Content-Type: application/json \
-d {message: 我这个月的跑步量相比上个月有什么变化？} \
https://api.transition.fun/api/v1/coach/chat
示例问题：
- - 我这周最长的跑步是多少？
- 我的最大摄氧量趋势如何？
- 根据我最近的Garmin数据，我是否过度训练？
- 比较我这个月与上个月的骑行功率
- 我的心率数据对我的体能状况有什么说明？
获取训练计划
检索指定日期范围内的预定训练。
bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15
参数：
- - start — 开始日期（YYYY-MM-DD，必填）
- end — 结束日期（YYYY-MM-DD，必填）
- start和end之间的最大范围为90天。
表现管理图表（PMC）
获取根据您的Garmin活动计算出的CTL（体能）、ATL（疲劳）和TSB（状态）。
bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/performance/pmc
表现统计
获取FTP、阈值配速、心率区间以及从您的Garmin数据中得出的其他指标。
bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/performance/stats
运动员资料
bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/profile
对话历史
bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/coach/history
推送训练到Garmin
将预定训练直接发送到您的Garmin设备。
bash
curl -X POST -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/workouts/123/push-garmin
速率限制
10,000/天 | 100/天 |
给代理的提示
- 1. 将教练对话作为主要界面。 它拥有用户Garmin活动、训练负荷和表现的完整上下文——只需提出自然的问题。
- 2. 在推荐高强度训练前检查疲劳程度。 调用GET /api/v1/performance/pmc并查看TSB。如果TSB低于-20，说明运动员处于疲劳状态。
- 3. 使用免费的WOD端点获取快速训练。 无需认证——非常适合只想获得训练建议的用户。
- 4. 所有日期参数的格式始终为YYYY-MM-DD。
