# 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.

- Skill: `majiayu000/route-builder` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/route-builder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/route-builder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/route-builder

---


## 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
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`.