Files
cycling-training/SKILL.md
T
Chris Farhood f6dd9dfc27 feat: add cycling-training Claude skill (MCP companion)
Modular cycling-training skill: periodization logic, workout design, and
research-backed protocols that companion an Intervals.icu MCP server (the
server owns all data + computed metrics; the skill owns knowledge + reasoning).

Structure:
- SKILL.md router + README (companion-to-MCP architecture, install steps)
- references/: durability, mtb-xco-demands, strength-for-cyclists,
  vo2max-intervals, periodization, data-confounds, citations
- assets/: base + build plan templates, durability field-test protocol

Every quantitative claim carries an inline citation; citations.md is the
single source of truth with PMID/DOI, each verified against PubMed on
2026-07-20. Notable honesty flags baked in:
- VO2 rep-length: running (Fleckenstein 2025) vs cycling (Ronnestad) conflict
  documented rather than asserted; cycling evidence favors short intervals.
- 'Yu et al. 2025' (frequency > distribution) could not be found; not cited.
- Under-researched doses (durability, taper TSB, CTL ramp) flagged 'track response'.
- HR-confound doc forbids naive decoupling<5% / RHR+5 rules.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TqrhBhC3GEcKyaw8RTk8G6
2026-07-20 18:59:37 -04:00

70 lines
4.4 KiB
Markdown

---
name: cycling-training
description: >-
Periodization logic, workout design, and research-backed protocols for endurance and off-road
cycling (road/TT + MTB/XCO). Companions an Intervals.icu MCP server that supplies all data and
computed metrics. Use when planning training blocks, designing VO2max/threshold/durability
workouts, integrating heavy strength (esp. masters), setting CTL ramp or A-race taper targets,
interpreting CTL/ATL/TSB or wellness trends, or deciding whether to trust HR vs power. Routes to
focused, individually loadable reference docs; every quantitative claim is cited.
---
# Cycling Training — knowledge & reasoning skill
This skill is the **reasoning half** of a two-part system. The **Intervals.icu MCP server owns all
data and computed metrics**; this skill owns the **knowledge and interpretation**. Get the numbers
from MCP, then use these docs to decide what they mean and what to do next.
## Data / knowledge split (read this first)
| Ask the **MCP server** for… | Ask **this skill** for… |
|---|---|
| Activities, streams, best efforts, power curves | What workout to prescribe and why |
| CTL / ATL / TSB, training-load ramp, TSS | How fast to ramp CTL; what TSB to target for an A-race |
| Zones, sport settings, thresholds (FTP, MAP) | How to structure work:rest and rep length within a zone |
| Wellness: HRV, RHR, sleep, readiness | Whether a wellness signal is trustworthy or confounded |
**Never recompute what MCP already returns** (zones, TSS, load metrics). This skill contains no
calculators by design — only periodization logic, workout design, protocols, and interpretation.
> Relevant MCP tools (names may vary by server): `get_athlete_summary`, `get_athlete_profile`,
> `get_sport_settings`, `get_activities` / `search_activities`, `get_activity_details` /
> `_streams` / `_intervals` / `_best_efforts`, `get_athlete_power_curves`, `get_wellness_data`,
> `get_training_readiness`, `get_events` / `add_or_update_event` (to schedule planned workouts).
## Router — load the doc that matches the need
| If the question is about… | Load |
|---|---|
| **Fatigue resistance / durability** — training it, why fatigued-state power matters, the field test | `references/durability.md` |
| **MTB / XCO** — race demands, why power (not HR) governs off-road, marathon vs lap XCO | `references/mtb-xco-demands.md` |
| **Strength training** — heavy lifting for cyclists, masters muscle loss, from-zero ramp, in-season | `references/strength-for-cyclists.md` |
| **VO2max / high-intensity intervals** — rep length, work:rest, maximizing time ≥90% VO2max | `references/vo2max-intervals.md` |
| **Season structure** — base/build/peak, mesocycles, CTL ramp, A-race taper & TSB targets, polarized vs pyramidal | `references/periodization.md` |
| **Trusting the data** — when HR is unreliable, decoupling, RHR/HRV, heat/alcohol/sleep/travel confounds | `references/data-confounds.md` |
| **A specific citation / PMID / DOI** | `references/citations.md` |
### Plan & protocol templates (assets)
| Template | Use when |
|---|---|
| `assets/plan-template-base.md` | Building a base mesocycle, backward-mapped from an A-race |
| `assets/plan-template-build.md` | Building a build block that integrates VO2, durability, and strength |
| `assets/field-test-durability.md` | Running the ~1,500 kJ → 1-min hill durability field test |
## Operating principles
1. **Cite as you reason.** Every quantitative recommendation should name its source (author/year;
full identifier in `references/citations.md`). This is so the athlete can verify, not just trust.
2. **Separate mechanism from dose.** Where a doc marks a protocol
`⚠️ under-researched — track individual response`, present it as a hypothesis to test on this
athlete, not a fixed prescription.
3. **Power governs; HR is conditional.** Prescribe from power. Use HR only where it is reliable
(durability decoupling on steady rides, recovery trends) and always screen for the confounds in
`references/data-confounds.md`. Never apply naive single-number rules
(e.g. "decoupling <5% = fresh", "RHR +5 = overtrained") without those caveats.
4. **Distribution is a principle, not a recipe.** Training age, volume, life stress, and phase
decide the intensity distribution — see `references/periodization.md`.
5. **Don't over-transfer.** Keep discipline-specific numbers labelled; small-n elite XCO data does
not automatically apply to masters marathon riders.