booking-timeline

Use when constructing the Booking & reservation timeline section of a trip plan. Encodes the 4-month / 2-month / 6-week / 1-week reservation cascade and refund-window rules. Invoked by trip-planner.

5 stars

Best use case

booking-timeline is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Use when constructing the Booking & reservation timeline section of a trip plan. Encodes the 4-month / 2-month / 6-week / 1-week reservation cascade and refund-window rules. Invoked by trip-planner.

Teams using booking-timeline should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/booking-timeline/SKILL.md --create-dirs "https://raw.githubusercontent.com/vamseeachanta/workspace-hub/main/.agents/skills/travel/booking-timeline/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/booking-timeline/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How booking-timeline Compares

Feature / Agentbooking-timelineStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Use when constructing the Booking & reservation timeline section of a trip plan. Encodes the 4-month / 2-month / 6-week / 1-week reservation cascade and refund-window rules. Invoked by trip-planner.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# booking-timeline

When to lock what. Reservations have hard deadlines: lodgings fill, scenic-train window seats sell out, fees lock. Get the order wrong and the trip falls apart.

## The 4-tier cascade

Render this as a Markdown table in the trip body. Adjust the lead-times by trip type (international ≥ 4 months out; domestic ≥ 6 weeks; weekend ≥ 1 week).

```markdown
## Booking & reservation timeline

| When | Action |
|---|---|
| **4–6 months out** | Lock dates, book flights, lodging |
| **2–3 months out** | Buy rail/transit pass; reserve scenic-train seats |
| **3–6 weeks out** | Reserve summit/peak attractions; travel insurance |
| **1–2 weeks out** | Confirm visa / ETIAS; download apps + offline maps |
| **Trip day** | Activate passes; check-in 24 hr ahead for flights |
```

## What goes in each tier

### 4–6 months out (the lock-in window)

Things that fill up earliest:

- **Flights** — international flights are cheapest 4–6 months out; US domestic 2–3 months
- **Peak-season lodging** — Swiss alpine villages (May–June), US national park gateway towns, Greek/Italian summer islands
- **Limited-capacity attractions:** Alhambra, Vatican Museums (Friday-night), Yosemite NP campsites, Antelope Canyon tours
- **Train passes** can wait until 2 months — most are open-dated until activation
- **Trip insurance** — buy within 14 days of first deposit for pre-existing-condition coverage

**For domestic / weekend trips: collapse this to "6 weeks out".**

### 2–3 months out (the seat-selection window)

- **Scenic-train seat reservations:** Glacier Express opens 3 months ahead; Bernina Express same; Eurostar opens 6 months
- **Restaurant reservations** at hyped places (Michelin, OpenTable cult restaurants)
- **Specific tour bookings:** guided national park tours, snorkel/dive trips, Northern Lights chases
- **Car rental** if needed — book early for August / Christmas / Easter peaks; otherwise OK to wait
- **Buy the rail pass** if it's open-dated until activation

### 3–6 weeks out (the experience window)

- **High-altitude / weather-dependent attractions:** Jungfraujoch slot, Pikes Peak time-entry, Yosemite Half Dome permit
- **Travel insurance** — buy by this point even if you didn't earlier
- **Cellular plan / SIM** — order international SIM, set up eSIM, or call carrier for travel package
- **Notify card issuers** of travel dates (most banks no longer require this, but some still flag transactions)

### 1–2 weeks out (the prep window)

- **Visa / ETIAS / ESTA** — verify approval status; some take 72 hrs to process
- **Download apps:** transit (SBB Mobile, Citymapper, etc.), maps offline, lodging confirmations as PDFs
- **Currency:** order foreign cash if needed for arrival expenses (taxis, tips). Or plan ATM withdrawal at the airport
- **Pack-list review:** specific to destination (altitude jacket? snorkel? rain gear?)
- **Pet / house sitter:** confirm dates; leave keys
- **Mail hold:** USPS or Amazon vacation hold

### Trip day & arrival

- **Activate the rail pass** on first travel day (most are app-validated, not paper)
- **Flight check-in:** 24 hrs ahead online to lock seat assignment
- **Carry-on essentials:** passport, prescriptions, charger, change-of-clothes, snack
- **Save offline:** lodging address + arrival instructions to phone

## Refund-window rules

These are the cancellation windows to look for when booking. Aim for the most flexible option that fits the budget.

| Item | Free-cancellation window to look for |
|---|---|
| Hotels | ≥ 30 days out (most have this; some chains offer 24 hrs) |
| Airbnb / Vrbo | "Flexible" or "Moderate" cancellation policy; avoid "Strict" |
| Flights (refundable) | Premium fare class only — usually not worth the markup |
| Flights (non-refundable) | 24-hour cancel window per US DOT for tickets bought directly from airline |
| Trip insurance | "Cancel for any reason" rider — pricier but recovers ~75% |
| Tours / activities | Look for "free cancellation up to 24/48/72 hrs before" |
| Rail passes | Most are non-refundable once activated; refundable if not yet activated |
| Scenic-train seat reservations | Often non-refundable supplements; flexible base fare on pass |

## The "what if dates change" rule

Build flexibility into the lock-in. If the trip dates might slip:

- Choose lodging with ≥ 30-day free-cancel
- Wait on non-refundable flights until dates are locked
- Hold the rail pass open-dated (don't activate)
- Postpone travel insurance until 14 days out (still within pre-existing coverage if you bought-then-canceled-and-rebought)

## Region-specific timing nuances

| Region | Booking timing nuance |
|---|---|
| US national parks | Lottery-based permits open 6 months ahead (Half Dome, The Wave); regular campsites 5 months ahead; lodge stays 13 months ahead |
| Switzerland | Glacier Express opens 90 days; Jungfraujoch is same-day in shoulder season but slot-based in summer |
| Italy | Restaurants in Tuscany / Cinque Terre book 1 month ahead in summer; Vatican Museums Fri-eve 60 days ahead |
| Japan | JR Pass must be bought BEFORE arrival (cheaper) or in-country at premium; Shinkansen reservations open 30 days ahead |
| UK | Tower of London / Stonehenge timed entry; book 2 months ahead in summer |
| Iceland | Northern Lights tours weather-dependent; lodging in Reykjavík fills 4 months ahead Sept–Mar |
| Greek islands | Ferries fill in August; book ferry + island lodging together 2 months ahead |

## Reference

- **#41 Beavers Bend:** cabins fill 6 months ahead in fall (peak); 2 months ahead in summer
- **#68 Switzerland:** full 4-tier timeline rendered in body; emphasizes Swiss Travel Pass open-dated flexibility + Glacier Express lock-in

Related Skills

knowledge-management-fix-timeline

5
from vamseeachanta/workspace-hub

Sub-skill of knowledge-management: Fix Timeline.

quantification-metrics-timeline

5
from vamseeachanta/workspace-hub

Sub-skill of quantification-metrics: Timeline (+2).

test-oversized-skill

5
from vamseeachanta/workspace-hub

A test fixture skill that exceeds 200 lines with multiple H2/H3 sections for split testing.

interactive-report-generator

5
from vamseeachanta/workspace-hub

Generate interactive HTML reports with Plotly visualizations from data analysis results. Supports dashboards, charts, and professional styling.

data-validation-reporter

5
from vamseeachanta/workspace-hub

Generate interactive validation reports with quality scoring, missing data analysis, and type checking. Combines Pandas validation, Plotly visualization, and YAML configuration for comprehensive data quality reporting.

agent-os-framework

5
from vamseeachanta/workspace-hub

Generate standardized .agent-os directory structure with product documentation, mission, tech-stack, roadmap, and decision records. Enables AI-native workflows.

OrcaFlex Specialist Skill

5
from vamseeachanta/workspace-hub

```yaml

repo-ecosystem-hygiene

5
from vamseeachanta/workspace-hub

Interpret the daily read-only repo ecosystem hygiene audit and route remediation through approved workflows.

domain-knowledge-sweep

5
from vamseeachanta/workspace-hub

Systematic multi-source research of an engineering domain. Spawns parent issue → 6 research subissues (Standards, Academic, Industry, LinkedIn-marketing, Code-audit, Synthesis) → gap implementation subissues. Replaces LinkedIn-only extraction with defensible comprehensive sourcing.

subagent-write-verification

5
from vamseeachanta/workspace-hub

Independently verify subagent-claimed file writes with filesystem and git checks before treating the artifact as real, before committing it, and before referencing the path in downstream prompts.

git-operation-serialization-preflight

5
from vamseeachanta/workspace-hub

Before any commit, stash, merge, reset, rebase, or checkout in a multi-agent or shared-checkout environment, run a bounded preflight to detect active git writers and stale index/config locks, then serialize the mutating step under a single-writer guarantee.

public-knowledge-graph-governance

5
from vamseeachanta/workspace-hub

Maintain public-safe knowledge graph artifacts for llm-wiki and similar markdown knowledge bases. Use when changing graph generators, validators, schema docs, weekly freshness checks, or public/private source-scope boundaries.