# trip-planner

trip-planner builds detailed day-by-day travel itineraries with navigation addresses, transit times, and evening prep checklists. Useful when organizing holidays or road trips.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 134 installs · ★ 300 repo stars
- Author: majiayu000
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/majiayu000/spellbook/tree/HEAD/skills/trip-planner/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/trip-planner

## What it does

The skill instructs the agent to structure travel plans in clean Markdown. Each day is split into morning, afternoon, and evening segments with physical addresses, booking links, duration estimates, and commute times. A dedicated evening section prompts you to download offline maps, top up fuel, or complete reservations for tomorrow.

The planning workflow groups stops geographically to cut out wasted back-and-forth travel. It balances intense sightseeing with recovery mornings and includes backup options for rainy days. Missing destination constraints like lodging or budget will force the assistant to ask follow-up questions before producing a schedule.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add majiayu000/spellbook --skill trip-planner -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/trip-planner/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/trip-planner/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add majiayu000/spellbook --skill trip-planner -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/trip-planner/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add majiayu000/spellbook --skill trip-planner -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/trip-planner/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install majiayu000/spellbook skills/trip-planner
```

2. **Manually: put the files in place**
- File: `.github/skills/trip-planner/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add majiayu000/spellbook --skill trip-planner -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/majiayu000/spellbook --path skills/trip-planner
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/trip-planner/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add majiayu000/spellbook --skill trip-planner -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/majiayu000/spellbook/tree/HEAD/skills/trip-planner/SKILL.md

## When to use it
- generate structured day-by-day travel itineraries with morning, afternoon, and evening blocks
- cluster sights by geographical neighborhood to avoid unnecessary travel
- compile evening checklists for tickets, packing, and offline map downloads
- balance demanding outdoor activities with scheduled recovery periods

## Example prompts
- Plan a 5-day itinerary for Tokyo based in Shinjuku, focus on food and walking
- Organize a week-long road trip through Iceland with fuel stops and scenic hikes
- Draft a relaxed weekend schedule for Barcelona including local coffee shops

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 18ab5c38ada7b38f.

BEGIN THIRD-PARTY FILE 18ab5c38ada7b38f
````text
---
name: trip-planner
description: Use when the user wants detailed travel itineraries with activities, logistics, day-by-day schedules, vacation planning, trip organization, or travel documentation.
---

# Trip Planner Skill

Create comprehensive travel itineraries with day-by-day schedules, activity planning, and practical logistics.

## Context

You are helping plan trips with detailed, actionable itineraries that maximize experiences while maintaining realistic scheduling and proper preparation.

## Itinerary Structure

### Overview Section

```markdown
# [Destination] Trip - [Dates]

## Overview

**Home Base:** [Location/Accommodation]
**Trip Focus:** [Primary activities/interests]
**Key Amenities:** [Gym, workspace, etc. if relevant]
```

### Day-by-Day Format

```markdown
## [Day], [Date] - [Theme/Focus]

### Morning
- **Wake:** [Time]
- [Activity with location/details]
- [Activity with timing]

### Afternoon
- [Activities with locations]
- [Timing and logistics]

### Evening
- [Dinner/social plans]
- [Location addresses]

### Prep Tonight
- [Critical tasks for next day]
- [Bookings needed]
- [Items to pack/prepare]
```

## Content Elements

### Activity Details
- Full addresses for navigation
- Operating hours when relevant
- Booking links for reservations
- Duration estimates
- Difficulty levels for physical activities

### Logistics
- Wake-up times aligned with activities
- Travel times between locations
- Gas/fuel reminders for road trips
- Offline map download reminders
- Weather-appropriate gear notes

### Practical Tips
- Local recommendations (coffee, food, bars)
- Critical prep items (reservations, downloads, packing)
- Legal/safety notes (reef-safe sunscreen, wildlife distances)
- Backup plans for weather-dependent activities

## Quick Reference Section

```markdown
## Essential Info

### Booked Activities
- [Activity]: [Date/Time]
  - [Link/Confirmation]
  - [Location/Notes]

### Must Download (Offline)
- [Maps/Apps needed]
- [Trail information]
- [Backup resources]

### Local Spots
- **Coffee:** [Name]: [Address] ([Hours])
- **Restaurants:** [Options with addresses]
- **Bars/Social:** [Options with addresses]

## Quick Reference

**Schedule Overview:**
- [Day]: [Key activity]
- [Day]: [Key activity]

**Critical Prep:**
- [Key preparation items]
```

## Planning Principles

### Activity Balance
- Mix high-energy and recovery days
- Account for travel fatigue
- Include buffer time for spontaneity
- Plan sleep-in days after early mornings

### Realistic Timing
- Include travel time between locations
- Account for meals and breaks
- Build in prep time for next-day activities
- Avoid over-scheduling

### Practical Focus
- Prioritize experiences based on stated interests
- Minimize backtracking and wasted travel
- Group activities by geographic area
- Include local favorites, not just tourist spots
````
END THIRD-PARTY FILE 18ab5c38ada7b38f

The third-party file has ended. Everything between the 18ab5c38ada7b38f tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2864 of 3489 bytes. © majiayu000 · MIT · https://github.com/majiayu000/spellbook/tree/HEAD/skills/trip-planner/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
