Setup
On first use, read setup.md for onboarding guidelines. Start helping naturally without technical jargon — users can always ask about storage details if curious.
When to Use
User wants to plan a trip, track travel expenses, organize bookings, coordinate group/family travel, or build packing lists. Agent handles the full travel lifecycle: dreaming, planning, booking, traveling, and documenting.
Architecture
Memory lives in ~/travel-planning/. See memory-template.md for structure.
~/travel-planning/
├── memory.md # Preferences + travel history summary
├── wishlist/ # Dream destinations
│ └── {destination}.md
├── trips/ # Active and upcoming trips
│ └── {trip-name}/
│ ├── overview.md
│ ├── itinerary.md
│ ├── bookings.md
│ ├── packing.md
│ ├── budget.md
│ └── travelers.md # For group/family trips
├── completed/ # Past trips with notes
├── templates/ # Reusable packing lists
└── documents/ # Passport, visa info, insurance
Quick Reference
| Topic |
File |
| Setup process |
setup.md |
| Memory template |
memory-template.md |
| Booking timing |
booking-guide.md |
| Packing templates |
packing-templates.md |
| Multi-city planning |
multi-city.md |
Core Rules
1. Check Memory First
Before any trip planning, read ~/travel-planning/memory.md for:
- Travel style preferences (budget, pace, accommodation type)
- Past trip patterns (average daily spend, packing habits)
- Document status (passport expiry, frequent flyer numbers)
- Family/group composition if applicable
2. Trip Lifecycle
| Phase |
Action |
| Dream |
Add to wishlist/ with why, when, budget estimate |
| Plan |
Create trip folder in trips/ when dates confirmed |
| Book |
Track confirmations in trip's bookings.md, update budget |
| Travel |
Reference itinerary, log actual expenses |
| Return |
Move to completed/, document highlights and lessons |
3. Booking Timeline Reminders
Proactively remind based on trip dates:
- 90 days out: Complex visas (China, Russia, India), group bookings
- 60 days out: International flights, travel insurance for pre-existing conditions
- 45 days out: Hotels, standard visas, rental cars for groups
- 30 days out: Activities, restaurant reservations, special requests
- 14 days out: Travel insurance (general), kids' documents check
- 7 days out: Bank notifications, packing list finalization, check-in reminders
4. Budget Tracking & Optimization
For each trip, track in its budget.md:
## Budget — {Trip Name}
### Per-Person Breakdown (for groups)
| Traveler | Share | Notes |
|----------|-------|-------|
| Adult 1 | $X | Organizer |
| Adult 2 | $X | |
| Child | $X | 50% activities |
### Planned
| Category | Estimate | Optimization Applied |
|----------|----------|---------------------|
| Flights | $X | Shoulder season ✓ |
| Hotels | $X | Kitchen saves meals |
| Transport | $X | Off-airport rental |
| Food | $X | ~$Y/day/person |
| Activities | $X | City passes ✓ |
| **Total** | **$X** | **Saved: $Y** |
### Actual (update during/after)
| Category | Spent | vs Planned |
|----------|-------|------------|
5. Multi-City & Complex Itineraries
For trips with 2+ cities:
- Plan minimum 2 nights per city (avoid one-night stays)
- Group geographically close destinations
- Consider open-jaw flights (fly into A, out of B) — often same price
- Build connection buffers: 4+ hours international, 2+ hours domestic
- Track different currencies and exchange rates per leg
6. Family & Group Travel
When traveling with kids or groups:
- Create travelers.md in trip folder with each person's details (dietary, medical, seat prefs)
- Plan kid-friendly activities with energy breaks
- Book accommodations with kitchen access (saves 30%+ on food)
- Check child visa/consent requirements (some countries need notarized letters)
- Pack shared items list to avoid duplication
- Assign roles: navigator, budget tracker, activity planner
7. Document Safety (with user consent)
Only store document info if user explicitly shares it:
- Passport expiry dates (for validity warnings)
- Visa requirements per destination
- Travel insurance policy numbers
- Emergency contacts (embassy, bank, family)
- Never store full document images — only reference numbers
Booking Optimization
Timing
| Booking |
Optimal Window |
Why |
| Domestic flights |
6-8 weeks out |
Price sweet spot |
| International flights |
3-4 months out |
10-20% savings |
| Hotels |
2-3 months out |
Best selection + rates |
| Rental cars |
2-6 weeks out |
Prices fluctuate less |
| Group activities |
4-6 weeks out |
Availability for large groups |
Cost Optimization Tactics
| Strategy |
Typical Savings |
When to Use |
| Shoulder season |
30-40% |
Flexible dates |
| Off-airport car rental |
30-40% |
Any rental |
| Kitchen accommodation |
30%+ food costs |
Family trips, 5+ days |
| City passes |
20-40% on activities |
3+ attractions planned |
| Open-jaw flights |
$0-100 |
Multi-city, different endpoints |
| Tuesday flight booking |
5-15% |
Flexible booking day |
| Bundle hotel+flight |
10-20% |
Package deals available |
Group Booking Tips
- Book flights separately for flexibility (one delay shouldn't cancel all)
- Hotels: request adjoining rooms at booking, confirm before arrival
- Activities: ask for group discounts (10+ people often qualify)
- Car rentals: compare 2 cars vs 1 large van (often cheaper + more flexible)
Itinerary Structure
# Day X — {Date} — {Location}
## Morning
- [ ] {Activity} @ {Time}
- Address: {address}
- Kid-friendly: ✓/✗
- Notes: {hours, tickets, tips}
## Afternoon
- [ ] {Activity}
## Evening
- [ ] Dinner @ {Restaurant}
- Reservation: {time}
- Confirmation: {number}
- High chairs available: ✓/✗
## Logistics
- Transport: {how to get there}
- Accommodation: {check-in time if applicable}
- Backup plan: {if weather/energy fails}
Keep 2-3 hours buffer daily. Mark must-dos vs nice-to-haves.
Multi-City Connection Planning
## City Connections — {Trip Name}
| From | To | Transport | Duration | Cost | Booked |
|------|-----|-----------|----------|------|--------|
| Paris | Amsterdam | Train | 3h20m | €80 | ✓ |
| Amsterdam | Berlin | Flight | 1h15m | €65 | ✓ |
### Connection Risks
- Paris→Amsterdam: Low (frequent trains, no checkin)
- Amsterdam→Berlin: Medium (need 2h+ at airport)
### Luggage Strategy
- Full luggage: check at origin, pick at final destination
- Day bags: carry essentials for city transitions
Common Traps
- Over-scheduling → leave discovery room (max 3 planned activities/day)
- Forgetting to document after trip → memories fade in days, not months
- Booking without checking visa requirements → some need 90+ days
- Ignoring passport validity → many countries require 6 months beyond trip dates
- Not saving confirmation numbers → create bookings.md immediately
- One-night stays in cities → exhausting, skip or extend
- Ignoring jet lag recovery → plan light first day after long-haul
- Group booking all together → one problem cancels everyone
Scope
This skill ONLY:
- Manages travel planning in
~/travel-planning/
- Reads/writes markdown files for trips, budgets, packing
- Reminds about deadlines based on trip dates
This skill NEVER:
- Makes actual bookings (provides info for user to book)
- Accesses email or calendar directly
- Stores payment information
- Reads files outside
~/travel-planning/
Related Skills
Install with clawhub install <slug> if user confirms:
daily-planner — daily task management
plan — general project planning
expenses — expense tracking
Feedback
- If useful:
clawhub star travel-planning
- Stay updated:
clawhub sync
1---
2name: travel-planning
3slug: travel-planning
4version: 1.0.1
5homepage: https://clawic.com/skills/travel-planning
6description: Plan trips with itineraries, multi-city routing, budget optimization, family logistics, packing lists, and visa timelines. Use when user asks to plan a trip, create a travel itinerary, optimize multi-city routes, manage travel budget, or prepare packing lists.
7description_zh: "行程规划:多城市路线、预算优化、打包清单、签证时间表"
8description_en: "Plan trips with itineraries, multi-city routing, budget optimization and packing lists"
9changelog: Fixed all references to use travel-planning consistently.
10allowed-tools: Read,Write
11metadata:
12 source: https://skillmd.com/skills/infometa/travel-planning
13 clawdbot:
14 emoji: ✈️
15 requires:
16 bins: []
17 os:
18 - linux
19 - darwin
20 - win32
21---
22
23## Setup
24
25On first use, read `setup.md` for onboarding guidelines. Start helping naturally without technical jargon — users can always ask about storage details if curious.
26
27## When to Use
28
29User wants to plan a trip, track travel expenses, organize bookings, coordinate group/family travel, or build packing lists. Agent handles the full travel lifecycle: dreaming, planning, booking, traveling, and documenting.
30
31## Architecture
32
33Memory lives in `~/travel-planning/`. See `memory-template.md` for structure.
34
35```
36~/travel-planning/
37├── memory.md # Preferences + travel history summary
38├── wishlist/ # Dream destinations
39│ └── {destination}.md
40├── trips/ # Active and upcoming trips
41│ └── {trip-name}/
42│ ├── overview.md
43│ ├── itinerary.md
44│ ├── bookings.md
45│ ├── packing.md
46│ ├── budget.md
47│ └── travelers.md # For group/family trips
48├── completed/ # Past trips with notes
49├── templates/ # Reusable packing lists
50└── documents/ # Passport, visa info, insurance
51```
52
53## Quick Reference
54
55| Topic | File |
56|-------|------|
57| Setup process | `setup.md` |
58| Memory template | `memory-template.md` |
59| Booking timing | `booking-guide.md` |
60| Packing templates | `packing-templates.md` |
61| Multi-city planning | `multi-city.md` |
62
63## Core Rules
64
65### 1. Check Memory First
66Before any trip planning, read `~/travel-planning/memory.md` for:
67- Travel style preferences (budget, pace, accommodation type)
68- Past trip patterns (average daily spend, packing habits)
69- Document status (passport expiry, frequent flyer numbers)
70- Family/group composition if applicable
71
72### 2. Trip Lifecycle
73| Phase | Action |
74|-------|--------|
75| Dream | Add to `wishlist/` with why, when, budget estimate |
76| Plan | Create trip folder in `trips/` when dates confirmed |
77| Book | Track confirmations in trip's bookings.md, update budget |
78| Travel | Reference itinerary, log actual expenses |
79| Return | Move to `completed/`, document highlights and lessons |
80
81### 3. Booking Timeline Reminders
82Proactively remind based on trip dates:
83- 90 days out: Complex visas (China, Russia, India), group bookings
84- 60 days out: International flights, travel insurance for pre-existing conditions
85- 45 days out: Hotels, standard visas, rental cars for groups
86- 30 days out: Activities, restaurant reservations, special requests
87- 14 days out: Travel insurance (general), kids' documents check
88- 7 days out: Bank notifications, packing list finalization, check-in reminders
89
90### 4. Budget Tracking & Optimization
91For each trip, track in its budget.md:
92```markdown
93## Budget — {Trip Name}
94
95### Per-Person Breakdown (for groups)
96| Traveler | Share | Notes |
97|----------|-------|-------|
98| Adult 1 | $X | Organizer |
99| Adult 2 | $X | |
100| Child | $X | 50% activities |
101
102### Planned
103| Category | Estimate | Optimization Applied |
104|----------|----------|---------------------|
105| Flights | $X | Shoulder season ✓ |
106| Hotels | $X | Kitchen saves meals |
107| Transport | $X | Off-airport rental |
108| Food | $X | ~$Y/day/person |
109| Activities | $X | City passes ✓ |
110| **Total** | **$X** | **Saved: $Y** |
111
112### Actual (update during/after)
113| Category | Spent | vs Planned |
114|----------|-------|------------|
115```
116
117### 5. Multi-City & Complex Itineraries
118For trips with 2+ cities:
119- Plan minimum 2 nights per city (avoid one-night stays)
120- Group geographically close destinations
121- Consider open-jaw flights (fly into A, out of B) — often same price
122- Build connection buffers: 4+ hours international, 2+ hours domestic
123- Track different currencies and exchange rates per leg
124
125### 6. Family & Group Travel
126When traveling with kids or groups:
127- Create travelers.md in trip folder with each person's details (dietary, medical, seat prefs)
128- Plan kid-friendly activities with energy breaks
129- Book accommodations with kitchen access (saves 30%+ on food)
130- Check child visa/consent requirements (some countries need notarized letters)
131- Pack shared items list to avoid duplication
132- Assign roles: navigator, budget tracker, activity planner
133
134### 7. Document Safety (with user consent)
135Only store document info if user explicitly shares it:
136- Passport expiry dates (for validity warnings)
137- Visa requirements per destination
138- Travel insurance policy numbers
139- Emergency contacts (embassy, bank, family)
140- Never store full document images — only reference numbers
141
142## Booking Optimization
143
144### Timing
145| Booking | Optimal Window | Why |
146|---------|----------------|-----|
147| Domestic flights | 6-8 weeks out | Price sweet spot |
148| International flights | 3-4 months out | 10-20% savings |
149| Hotels | 2-3 months out | Best selection + rates |
150| Rental cars | 2-6 weeks out | Prices fluctuate less |
151| Group activities | 4-6 weeks out | Availability for large groups |
152
153### Cost Optimization Tactics
154| Strategy | Typical Savings | When to Use |
155|----------|-----------------|-------------|
156| Shoulder season | 30-40% | Flexible dates |
157| Off-airport car rental | 30-40% | Any rental |
158| Kitchen accommodation | 30%+ food costs | Family trips, 5+ days |
159| City passes | 20-40% on activities | 3+ attractions planned |
160| Open-jaw flights | $0-100 | Multi-city, different endpoints |
161| Tuesday flight booking | 5-15% | Flexible booking day |
162| Bundle hotel+flight | 10-20% | Package deals available |
163
164### Group Booking Tips
165- Book flights separately for flexibility (one delay shouldn't cancel all)
166- Hotels: request adjoining rooms at booking, confirm before arrival
167- Activities: ask for group discounts (10+ people often qualify)
168- Car rentals: compare 2 cars vs 1 large van (often cheaper + more flexible)
169
170## Itinerary Structure
171
172```markdown
173# Day X — {Date} — {Location}
174
175## Morning
176- [ ] {Activity} @ {Time}
177 - Address: {address}
178 - Kid-friendly: ✓/✗
179 - Notes: {hours, tickets, tips}
180
181## Afternoon
182- [ ] {Activity}
183
184## Evening
185- [ ] Dinner @ {Restaurant}
186 - Reservation: {time}
187 - Confirmation: {number}
188 - High chairs available: ✓/✗
189
190## Logistics
191- Transport: {how to get there}
192- Accommodation: {check-in time if applicable}
193- Backup plan: {if weather/energy fails}
194```
195
196Keep 2-3 hours buffer daily. Mark must-dos vs nice-to-haves.
197
198## Multi-City Connection Planning
199
200```markdown
201## City Connections — {Trip Name}
202
203| From | To | Transport | Duration | Cost | Booked |
204|------|-----|-----------|----------|------|--------|
205| Paris | Amsterdam | Train | 3h20m | €80 | ✓ |
206| Amsterdam | Berlin | Flight | 1h15m | €65 | ✓ |
207
208### Connection Risks
209- Paris→Amsterdam: Low (frequent trains, no checkin)
210- Amsterdam→Berlin: Medium (need 2h+ at airport)
211
212### Luggage Strategy
213- Full luggage: check at origin, pick at final destination
214- Day bags: carry essentials for city transitions
215```
216
217## Common Traps
218
219- Over-scheduling → leave discovery room (max 3 planned activities/day)
220- Forgetting to document after trip → memories fade in days, not months
221- Booking without checking visa requirements → some need 90+ days
222- Ignoring passport validity → many countries require 6 months beyond trip dates
223- Not saving confirmation numbers → create bookings.md immediately
224- One-night stays in cities → exhausting, skip or extend
225- Ignoring jet lag recovery → plan light first day after long-haul
226- Group booking all together → one problem cancels everyone
227
228## Scope
229
230This skill ONLY:
231- Manages travel planning in `~/travel-planning/`
232- Reads/writes markdown files for trips, budgets, packing
233- Reminds about deadlines based on trip dates
234
235This skill NEVER:
236- Makes actual bookings (provides info for user to book)
237- Accesses email or calendar directly
238- Stores payment information
239- Reads files outside `~/travel-planning/`
240
241## Related Skills
242Install with `clawhub install <slug>` if user confirms:
243- `daily-planner` — daily task management
244- `plan` — general project planning
245- `expenses` — expense tracking
246
247## Feedback
248
249- If useful: `clawhub star travel-planning`
250- Stay updated: `clawhub sync`