How does it integrate with my existing code?

It is designed to emit output compatible with v0/lib/routeHelpers.ts and integrates with the v0/app/api/route/build API endpoint.

Does it consider runner safety?

Yes, it includes guardrails to exclude unsafe surfaces and avoid steep grades for beginners, or suggest shorter routes in high-risk conditions.

What happens if location data is missing?

The skill will request clarification from the user and emit a 'SafetyFlag: missing_data' to ensure no invalid routes are generated.

What does the Route Builder skill do?

It generates detailed route specifications, including distance, elevation, and segments, formatted specifically for the app's mapping layer.

Can I specify surface types like trail or road?

Yes, the skill allows you to provide preferences for surfaces and elevation to tailor the route to specific training needs.

Route Builder

Name: Route Builder
Author: nadavyigal

bynadavyigal

•

Mobile Development

Generates optimized running route specifications with safety constraints and elevation data for fitness applications.

Route Builder is a specialized Claude Code skill designed for the Codex running coach application. It automates the creation of runnable route specifications by processing user requirements such as target distance, time, and surface preferences. The skill ensures technical compatibility with the application's mapping layer and internal helper libraries, while prioritizing safety by filtering out unsuitable terrain or excessive grades based on the runner's profile and current conditions.

Key Features

01Automated route specification generation based on distance and time targets

02Elevation profile mapping and grade constraint enforcement

03Surface-type filtering for trail, road, or pavement preferences

04Integrated safety guardrails for beginner runners and environmental risks

05Direct compatibility with routeHelpers.ts and mapConfig.ts integration points

061 GitHub stars

Use Cases

01Creating custom marathon training routes with specific elevation gains

02Automating route suggestions within a training plan based on scheduled workout intensity

03Generating safe, beginner-friendly 5k loops starting from a user's current location

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nadavyigal/running-coach- route-builder

For use in Claude.ai and ChatGPT

Download Skill