| name | trip-planner |
| description | Use when the user asks to plan, draft, or refine a leisure trip โ weekend getaway, road trip, international rail trip, or beach vacation. Triggers on phrases like "plan a trip", "trip to X", "weekend ideas", "X-day trip", "where should we go", "draft an itinerary". Routes through the travel-skill family (itinerary-design, lodging-selection, transport-and-passes, visual-review-board, risk-and-redundancy, booking-timeline, cost-estimation) and writes a GitHub issue body in the canonical achantas-data format. Skip for business travel logistics, expense reports, or non-trip questions. |
| type | process |
trip-planner โ entry skill
You are acting as a travel agent producing a complete, review-ready trip plan. The output is a GitHub issue body in vamseeachanta/achantas-data that the family can read and act on without further translation. Optimize for "no surprises" โ surface known failure modes (closures, motion sickness, sold-out reservations) in the plan itself, not after they happen.
Trip type detection (first thing you do)
Before drafting anything, classify the trip into one of these archetypes. The classification drives which sub-skills to invoke and what depth each section needs.
| Archetype | Signals | Apply skills |
|---|
| Weekend domestic | โค 3 days, drivable from home base, single destination | itinerary-design (light), lodging-selection, risk-and-redundancy, cost-estimation |
| Domestic road trip | 4โ7 days, multiple stops, drive-based, US states | itinerary-design, lodging-selection, transport-and-passes (drive-time honesty), visual-review-board, risk-and-redundancy, cost-estimation |
| International rail / multi-city | 5+ days, foreign country, train-anchored | ALL skills, with transport-and-passes and booking-timeline as load-bearing |
| Beach / single-resort | 3โ7 days, fly-in, one base | itinerary-design (light), lodging-selection, risk-and-redundancy (weather/water), cost-estimation |
| Idea / ranking | "What should we do" / comparison | ranking-matrix template; defer detailed planning |
If unsure, ask one clarifying question before proceeding (How long, and is this drive-based or fly-based?). Don't ask more โ extract the rest from defaults.
Mandatory issue-body sections
Every trip issue body MUST include these in this order. Sections marked load-bearing must not be omitted; sections marked skip-if-N/A may be cut for shorter trips.
- Summary (3โ5 lines) โ what the trip is, the high-level shape
- Trip parameters table โ duration, anchor airport/city, season, budget posture, passport/visa note (skip-if-N/A for domestic)
- Visual review board โ Markdown table with 3โ5 destination-specific photo rows (see
visual-review-board skill โ load-bearing, no generic regional banners)
- Recommended scenic train rides / drives โ what makes the trip scenic
- Suggested day-by-day itinerary with overnight base each night
- Lodging recommendations โ see
lodging-selection skill
- Booking & reservation timeline โ see
booking-timeline skill (skip-if-N/A for weekend trips)
- Estimated cost ballpark โ see
cost-estimation skill
- Planning checklist with
- [ ] checkboxes
- Watch-outs โ load-bearing โ closures, weather, motion sickness, altitude, kid logistics, Sunday/holiday closures, etc. (see
risk-and-redundancy skill)
- Related โ link to prior trip issues in the same repo
Hard rules (do not violate)
- No fabricated specific listings. Use search criteria for Airbnb/Vrbo (towns + filters), not invented listing IDs. For hotels, named properties OK only for established brands you can verify.
- No fabricated train schedules. Times are "approx ~2 hrs"; always direct the reader to the operator's booking site for current schedules.
- No NPS regional homepage banners as photos. They repeat across destinations and look generic. See
visual-review-board skill.
- Drive times must be honest. Houston โ Kansas Flint Hills is 9โ10+ hours, not "a weekend". If the drive doesn't fit the requested duration, say so explicitly in Trip parameters.
- Every trip has at least one "what could go wrong" entry. Even a weekend Galveston trip has a watch-out (red tide, ferry wait, hurricane season). See
risk-and-redundancy.
- Verify image URLs in the main session. Don't trust a subagent's "verified 200" claim โ re-curl in the conversation that's writing the issue. (Lesson: #68 had two 800px Wikimedia URLs return 400 despite agent verification.)
- Tense discipline. Trip plans describe future work โ never write past-tense as if reservations were already made.
- Inline gh issue URLs. Render
#NNNN references as [#NNNN](https://github.com/...) Markdown hyperlinks per the user's feedback_inline_gh_issue_url rule.
Lightweight trip-maintenance exception
If the user asks to "make note of" activities, preserve a shortlist, add selected options, or update an existing trip record, do not default to the full trip-plan template. Treat it as a trip-maintenance update: find/use the existing vamseeachanta/achantas-data trip issue, add a compact issue comment or note with the source URL and selected items, and report the issue/comment URL. See references/activity-shortlist-note-workflow.md.
Nearby alternative exploration exception
If the user asks to explore alternatives to a known trip/destination vibe (for example, "Broken Bow-style cabin but closer"), treat it as an idea / ranking task unless they ask for booking-ready listings. Capture the reference vibe as concrete filters, create/reuse a GitHub tracking issue when requested, compare candidates against any known cost baseline, and post a compact ranked exploration comment rather than forcing the full trip-plan template. See references/nearby-cabin-alternative-exploration.md.
Package-deal comparison issue-tree exception
If the user asks to compare package deals across multiple countries, regions, resorts, or operators, create/reuse a parent comparison issue and one child issue per serious option instead of forcing the full single-trip template into one issue. Keep vendor-access confidence explicit: search-index snippets identify leads only; live package names/prices/inclusions need normal/member-session verification before booking claims. See references/package-deal-comparison-issue-tree.md.
For Costco Travel, member-only portals, guided vacations, or other package vendors where pricing may require a logged-in session or phone quote, follow references/member-package-deal-verification.md: capture the visible CTA, package ID/date season/inclusions, and classify the price as verified online, quote required, or lead only rather than implying an all-in total.
Trip portfolio / ranking dashboard exception
If the user asks for "all the trips we planned", a grouped portfolio, or a cost-and-comfort ranking across prior trip ideas, do not create a new full trip issue by default. Treat it as a portfolio synthesis task:
- Mine existing trip issues, repo
_travel/** artifacts, and session handoffs for the planned trip set, costs, durations, and open decision notes.
- Group by the user's requested decision axis (for example, local/drive-based vs international) and keep source issue numbers visible for traceability.
- Rank by the user's family constraints, not by generic tourism appeal. For this family, comfort-first ranking should weigh travel effort, predictable lodging, quiet fallback time, kitchen/laundry, medical access, cancellation flexibility, sensory load, and easy abort paths ahead of sightseeing density.
- When the user asks for HTML, produce a self-contained HTML artifact with embedded CSS/data; for Telegram/Deckhand deliverables, save under the configured deliverables directory when a channel policy specifies one, then verify the file opens and has no browser console errors before reporting the path.
- Mark cost ranges as planning estimates unless freshly verified at booking time; use
quote required / see plan instead of inventing all-in totals where the source plan did not contain one.
Workflow
- Detect trip archetype (above), unless this is a lightweight trip-maintenance update.
- For lightweight activity notes, follow
references/activity-shortlist-note-workflow.md and skip the full template.
- For package-deal comparisons across multiple options, follow
references/package-deal-comparison-issue-tree.md and use a parent/child issue tree.
- Ask the one clarifying question if needed; otherwise proceed.
- Draft each mandatory section in order, invoking the named sub-skill for that section.
- Verify all photo URLs (
curl -sI -L -A "<UA>" โ see visual-review-board skill for the exact pattern).
- Write the body to a temp file (
/tmp/trip-<slug>.md).
- Create the issue:
gh issue create --repo vamseeachanta/achantas-data --title "Travel Plan: <X>" --body-file /tmp/trip-<slug>.md --label documentation.
- Report the new issue URL to the user.
Lightweight trip-note updates
When the user asks to "make note", "add this to the trip", "currently selected", or otherwise provides a small trip-planning delta, do not default to creating a new full trip issue. Instead:
- Search
vamseeachanta/achantas-data for the existing trip issue using destination/activity terms.
- Prefer updating/commenting on the existing active trip issue when one clearly matches.
- Capture the source URL, the selected items, and short planning implications in a concise issue comment with a stable marker.
- Verify the final comment URL/body before reporting success.
- Only create a new issue if no existing trip issue clearly covers the destination or the user explicitly asks for a new plan.
When to refer to the templates
The canonical structures live in .claude/skills/travel/templates/:
trip-issue-body.md โ for parent trips (#19, #41โ#45, #68)destination-issue-body.md โ for individual destinations (#46โ#66)ranking-matrix.md โ for cross-trip comparison (#67)
Open the relevant template and fill it in; don't re-invent the section layout.
Reference โ past trips that calibrated this skill
| Issue | What it taught us |
|---|
| #19 | Multi-state US road trip; how Houston-anchored timing works |
| #41 | Photo-rich destination issue (7 photos, all Beavers Bend specific) โ the gold standard |
| #42โ#45 | Parent-trip pattern; destination-specific photos required, not regional banners |
| #46โ#66 | Single-destination issues; one photo, brief checklist |
| #67 | Ranking matrix across destinations |
| #68 | International rail trip (Switzerland 1-week); hotel + 2 Airbnb pattern; jet-lag-day routing |
