jakubrohleder/agent-toolkit

Overview

This skill converts written or scanned training programs into Hevy-compatible routines and automates routine creation via the Hevy API. It extracts exercises, matches them to Hevy exercise IDs, builds the required JSON structure, and uploads routines from the CLI.

How this skill works

The tool parses input (text, PDF, or image) to identify exercises, sets, reps, weights, rest, and superset structure. It looks up canonical exercise IDs with hevy exercises search, generates a properly wrapped routine JSON template, enforces set-property rules by exercise type, and creates the routine using hevy routines create. Built-in safeguards handle unit conversion, superset mapping, and API rate limits.

When to use it

• Importing a full program (PPL, 5x5, 531, GZCLP, nSuns, Starting Strength, PHUL, PHAT, etc.) into Hevy
• Converting a PDF or image workout plan into Hevy JSON
• Looking up correct Hevy exercise IDs and equipment variants
• Building or editing routine JSON before creating via API
• Syncing multiple routines to Hevy with rate-limit handling

Best practices

• Always search exercises with hevy exercises search — never guess IDs
• Wrap the payload as {"routine": {...}}; do not submit a bare object
• Never include @ in notes (use 'at') to avoid silent 400 errors
• Match set properties to the exercise type (weight_reps, reps_only, duration, distance_duration, short_distance_weight)
• Convert lbs to kg and round to the nearest 0.5 kg for weight_kg values
• For bulk imports, create one routine first, then upload others with small delays and backoff on 429

Example use cases

• Scan a coach’s printed 12-week hypertrophy plan and generate routine JSON for Hevy
• Convert a 5x5 program PDF into individual Hevy routines and upload them via CLI
• Look up IDs for exercises with multiple equipment variants (barbell vs dumbbell) before building routines
• Create superset structures (A1/A2) with shared superset_id and rest only on the last exercise
• Bulk import a set of 10+ routines with automatic 2-second delays and 60s retry on rate limits