route-builder

nadavyigal's avatarfrom nadavyigal

Generates route specifications (distance, elevation, constraints) compatible with the app’s mapping layer.

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026
[API Helpers]

When & Why to Use This Skill

The route-builder skill is a specialized utility designed to generate precise, map-ready route specifications including distance, elevation, and safety constraints. It bridges the gap between user intent and technical mapping layers by producing data structures compatible with internal APIs and helper libraries, ensuring that generated routes are both runnable and safe.

Use Cases

  • Dynamic Route Generation: Creating custom running or cycling paths based on specific user requests for distance, time, and preferred elevation profiles.
  • Automated Workout Planning: Automatically generating missing route specifications for scheduled fitness activities within a training calendar to ensure plan completeness.
  • Safety-Conscious Navigation: Filtering and adjusting routes to exclude hazardous surfaces or steep inclines for beginners, while incorporating real-time safety flags for missing location data.
nameroute-builder
descriptionGenerates route specifications (distance, elevation, constraints) compatible with the app’s mapping layer.
short-descriptionBuilds runnable routes with safety constraints and map-ready specs.

When Codex should use it

  • When the user requests a new route for a target distance/time.
  • During plan creation if a route is missing for an upcoming workout.

Invocation guidance

  1. Provide target distance/time, surfaces, elevation preferences, and start location/constraints.
  2. Return route spec with segments, elevation notes, and safety considerations.
  3. Ensure output is compatible with v0/lib/routeHelpers.ts and mapConfig.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_invoked with distance, surface, safety_flags.