itinerary-optimizer — Claude Code skill: route a multi-stop trip
Builds a day-by-day route for trips with several stops: transfers, reservation windows and slack for whatever comes up. Useful when the plan is packed too tight.
npx skills add OneWave-AI/claude-skills --skill itinerary-optimizer -a claude-codeWhat itinerary-optimizer does
The skill turns a list of places into a schedule. The agent orders the stops, estimates travel time between them, and slots restaurant or activity bookings into the hours you will actually be nearby. A buffer is set aside too, so one delay does not break the whole day.
Under the hood it is an instruction file that tells the agent to act as a travel logistics planner. Output follows a fixed template with a recommendations block and next steps, plus a backup plan if something falls through. That fixed shape means you can paste the result into notes or pass it along.
It is meant for trips with multiple stops. For a single city in a single evening there is nothing to optimize, so the skill adds little. Install runs through npx skills add, and GitHub Copilot uses gh skill install instead.
What it helps with
- fit five cities into a week without losing half a day to transfers
- book dinner for the hour you will actually be in that neighborhood
- keep slack in the day for an unplanned stop
- estimate travel time between route points
- have a backup plan ready when the day falls apart
Example prompts for the agent
- Plan a 4-day route through Rome, Florence and Bologna. Account for train transfers and leave half a day of buffer.
- Lay out these places across the days and tell me which hours to book dinner for.
- Give me a backup version of the route in case it rains on day three.
How to install itinerary-optimizer
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill itinerary-optimizer -a claude-code2Manually: put the files in place
~/.claude/skills/itinerary-optimizer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/itinerary-optimizer/
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill itinerary-optimizer -a codex2Manually: put the files in place
.agents/skills/itinerary-optimizer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill itinerary-optimizer -a cursor2Manually: put the files in place
.cursor/skills/itinerary-optimizer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills itinerary-optimizer2Manually: put the files in place
.github/skills/itinerary-optimizer/SKILL.md1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill itinerary-optimizer -a gemini-cli2Platform CLI
gemini skills install https://github.com/OneWave-AI/claude-skills --path itinerary-optimizerManually: put the files in place
.devin/skills/itinerary-optimizer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill itinerary-optimizer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about itinerary-optimizer
How do I install itinerary-optimizer in Claude?
Run npx skills add OneWave-AI/claude-skills --skill itinerary-optimizer -a claude-code. The skill file then sits at ~/.claude/skills/itinerary-optimizer/SKILL.md.
What does itinerary-optimizer do?
It plans a multi-stop trip: stop order, travel time, booking windows and buffer for spontaneity. You get a day-by-day schedule with recommendations and a backup plan.
Which platforms does the skill support?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Each has its own install command, for example npx skills add OneWave-AI/claude-skills --skill itinerary-optimizer -a cursor.
Source text
SKILL.md · MIT
---
name: itinerary-optimizer
description: Efficiently route multi-stop trips with time management. Include transportation, restaurant/activity reservations timeline, and buffer time for spontaneity.
---
# Itinerary Optimizer
Efficiently route multi-stop trips with time management. Include transportation, restaurant/activity reservations timeline, and buffer time for spontaneity.
## Instructions
You are an expert travel planner and logistics optimizer. Create efficient, realistic itineraries that don't overpack days. Include: routing optimization, realistic time allocations, transportation between locations, reservation timing, buffer for spontaneity, and backup plans. Balance structure with flexibility.
### Output Format
```markdown
# Itinerary Optimizer Output
**Generated**: {timestamp}
---
## Results
[Your formatted output here]
---
## Recommendations
[Actionable next steps]
```
### Best Practices
1. **Be Specific**: Focus on concrete, actionable outputs
2. **Use Templates**: Provide copy-paste ready formats
3. **Include Examples**: Show real-world usage
4. **Add Context**: Explain why recommendations matter
5. **Stay Current**: Use latest best practices for travel
### Common Use Cases
**Trigger Phrases**:
- "Help me with [use case]"
- "Generate [output type]"
- "Create [deliverable]"
**Example Request**:
> "[Sample user request here]"
**Response Approach**:
1. Understand user's context and goals
2. Generate comprehensive output
3. Provide actionable recommendations
4. Include examples and templates
5. Suggest next steps
Remember: Focus on delivering value quickly and clearly!
© OneWave-AI · MIT · OneWave-AI/claude-skills
