route-builder
Generates route specifications with distance and elevation constraints. Use when user asks for route suggestions, wants to explore new running paths, or needs safer surface recommendations for upcoming workouts.
When & Why to Use This Skill
This Claude skill provides an automated solution for generating precise running and workout route specifications. It solves the challenge of manual path planning by intelligently factoring in distance, elevation, and surface safety constraints to produce map-ready data. By streamlining the transition from user intent to technical route specs, it ensures that workout suggestions are both safe for the user and technically compatible with mapping frameworks.
Use Cases
- Personalized Workout Planning: Automatically generate routes that match specific distance or time targets for marathon training or daily exercise.
- Safety-Conscious Exploration: Discover new running paths that prioritize safe surfaces and avoid steep grades, ideal for beginners or those in injury recovery.
- Technical Data Integration: Produce structured route specifications (segments, elevation notes, and safety flags) that are directly compatible with mapping UI components and backend APIs.
| name | route-builder |
|---|---|
| description | Generates route specifications with distance and elevation constraints. Use when user asks for route suggestions, wants to explore new running paths, or needs safer surface recommendations for upcoming workouts. |
| short-description | Builds runnable routes with safety constraints and map-ready specs. |
When Claude should use this skill
- When the user requests a new route for a target distance/time
- During plan creation if a route is missing for an upcoming workout
- When user wants route exploration or safer surface options
Invocation guidance
- Provide target distance/time, surfaces, elevation preferences, and start location/constraints.
- Return route spec with segments, elevation notes, and safety considerations.
- Ensure output is compatible with
v0/lib/routeHelpers.tsandmapConfig.ts.
Input schema
See references/input-schema.json.
Output schema
See references/output-schema.json.
Integration points
- UI: Route selector modal; map layer in
v0/lib/mapConfig.ts. - API:
v0/app/api/route/build(new) backed by existing mapping helpers.
Safety & guardrails
- Exclude unsafe surfaces if flagged; avoid steep grades for beginners.
- If location data missing, request clarification and emit
SafetyFlag: missing_data. - No medical advice; suggest shorter routes if heat/injury risk.
Telemetry
- Emit
ai_skill_invokedwithdistance,surface,safety_flags.