kaiord-workout-files

Kaiord workout files

Kaiord converts structured workout files between FIT, TCX, ZWO (Zwift), GCN (Garmin Connect JSON) and KRD, its canonical JSON format. Every conversion goes through KRD. Where both formats can express a step, values survive within fixed tolerances (time ±1 s, power ±1 W or ±1 %FTP, heart rate ±1 bpm, cadence ±1 rpm). Where the target cannot express one (for example a Garmin repetition-count end condition, which becomes an open duration in KRD), Kaiord logs a Lossy conversion: warning naming what it substituted.

Use this skill when a user wants to move a workout between training platforms, check that a file survives a conversion, or read what a workout file contains.

Option A: the MCP server (preferred for agents)

Add the stdio server to the client configuration:

{
  "kaiord": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@kaiord/mcp"]
  }
}

Tools:

• kaiord_list_formats lists the supported formats and what each can do.
• kaiord_convert converts between FIT, TCX, ZWO, GCN and KRD.
• kaiord_inspect parses any supported file and summarizes it.
• kaiord_validate validates KRD JSON against the schema.
• kaiord_diff compares two workout files.
• kaiord_extract_workout extracts the structured workout definition.
• kaiord_round_trip_validate checks a FIT file only: FIT → KRD → FIT, reporting drift beyond the tolerances. It does not accept TCX or ZWO and does not compare a converted file with its source.

Resources: kaiord://schema/krd (KRD JSON Schema), kaiord://formats, kaiord://docs/krd-format.

Option B: the CLI

npm install -g @kaiord/cli
kaiord convert --input workout.fit --output workout.krd
kaiord convert --input "workouts/*.fit" --output-dir converted/
kaiord validate --input workout.fit

The format is detected from the file extension; override it with --input-format.

Rules

• Convert through KRD; do not hand-edit FIT binaries.
• Before telling the user a converted file is safe to upload, check the actual output: kaiord_inspect it and kaiord_diff it against the source. kaiord_round_trip_validate covers FIT sources only.
• Report every Lossy conversion: warning to the user; never present a lossy conversion as exact.
• Kaiord runs locally. Do not upload a user's workout files anywhere to convert them.