Agent skill

Trip Planner

by borski in borski/travel-hacking-toolkit

Full trip planning orchestration. An agent skill from borski/travel-hacking-toolkit.

MITAuto-check passed

Install Trip Planner

skills CLI
$ npx skills add borski/travel-hacking-toolkit --skill trip-planner -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borski/travel-hacking-toolkit trip-planner --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borski/travel-hacking-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/travel-hacking-toolkit/skills/trip-planner .claude/skills/trip-planner && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
trip-planner
GitHub stars
688
Token cost
~2.1k tokens
SKILL.md length
879 words
Files
1
Skills in repo
46
Repo updated
First seen
Licence
MIT

At a glance

Full trip planning orchestration. An agent skill from borski/travel-hacking-toolkit.

  • Works in 6 steps: Parse Trip Parameters → Run Searches in Parallel → Combine into Trip Cost Matrix → …
  • The user says plan a trip
  • SKILL.md covers When to Use, When NOT to Use, Workflow and Error Handling, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Trip Planner is an agent skill from borski/travel-hacking-toolkit. Full trip planning orchestration. Combines flight search, hotel search, and points optimization into one cost analysis. Use when the user says "plan a trip" or wants the complete picture for a destination.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: AI-powered travel hacking and search with cash, points, miles, and award flights. Drop-in skills and MCP servers for Claude, Codex, and OpenCode. The licence is MIT.

When your agent uses it

  • The user says plan a trip
  • Wants the complete picture for a destination

Example prompts

  • “plan a trip”
  • “/trip-planner”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Parse Trip Parameters
  2. Run Searches in Parallel
  3. Combine into Trip Cost Matrix
  4. Calculate Value Scores
  5. Present the Trip Plan
  6. Source Status

What it can do on your machine

Read from SKILL.md and the folder at commit db82131. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Trip Planner loads about 2.1k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 879 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from borski/travel-hacking-toolkit at commit db82131, republished under its MIT licence (© borski). 879 words, ~2,082 tokens.

Download SKILL.mdSave it as .claude/skills/trip-planner/SKILL.md (or your agent's skills folder).
name
trip-planner
description
Full trip planning orchestration. Combines flight search, hotel search, and points optimization into one cost analysis. Use when the user says "plan a trip" or wants the complete picture for a destination.
category
orchestration
summary
Full trip planning. Flights + hotels + points in one shot.
api_key
Uses individual skill keys

Companion reference skills. Load these for deeper context:

  • flight-search-strategy — full search workflow and source priority
  • lessons-learned — Seats.aero workflow and common failure modes (load before any award search)
  • points-valuations — CPP rules, opportunity cost
  • partner-awards — reachability through alliance + bilateral partnerships
  • award-sweet-spots — flag legendary redemptions
  • booking-guidance — booking flow + phone numbers + the "hold before transfer" rule
  • transfer-bonuses — live current transfer bonuses (weekly refresh) before recommending any transfer
  • stopovers — per-program stopover rules; can turn a one-trip plan into a multi-city itinerary at no extra mileage cost
  • award-holds — per-program hold rules; affects transfer timing decisions
  • round-the-world — when the trip request implies 3+ stops or multiple regions, RTW products may be cheaper than separate awards
  • status-match — when a user mentions wanting status or asks about elite tier shortcuts; covers free direct matches, paid concierge fees, and once-per-lifetime warnings

Trip Planner

"Plan a trip to Paris Aug 11-15" answered with one complete cost breakdown.

Orchestrates compare-flights, compare-hotels, transfer-partners, and trip-calculator into a unified trip analysis. Shows total trip cost in cash vs every available points strategy.

This is an orchestration skill. It tells the agent which skills to invoke and how to combine their outputs.

When to Use

  • "Plan a trip to Paris Aug 11-15"
  • "What's the cheapest way to do SFO to Tokyo for a week in September?"
  • "How much would a trip to Stockholm cost in points vs cash?"
  • Any request that involves both flights AND accommodation

When NOT to Use

  • Flight-only comparison (use compare-flights)
  • Hotel-only comparison (use compare-hotels)
  • Award calendar (use award-calendar)
  • "Should I use points?" without a specific trip (use trip-calculator)

Workflow

Step 1: Parse Trip Parameters

Extract from the user's request:

ParameterExampleRequired
OriginSFOYes
DestinationParis / CDGYes
Departure date2026-08-11Yes
Return date2026-08-15Yes (assume one-way if not given)
Travelers2 adultsDefault: 1
Cabin classBusinessDefault: Economy
PreferencesFHR hotels, nonstop flightsOptional

If anything is ambiguous, ask. Don't guess dates or travelers.

Step 2: Run Searches in Parallel

Launch ALL searches simultaneously. Don't wait for one to finish before starting another.

PARALLEL:
  1. compare-flights: origin → destination, departure date, cabin
  2. compare-flights: destination → origin, return date, cabin (if round-trip)
  3. compare-hotels: destination, checkin = departure, checkout = return

Each of these internally runs their own parallel sub-searches (Duffel, Ignav, seats.aero, Chase, Amex, SerpAPI, Trivago, LiteAPI, Airbnb, etc).

Step 3: Combine into Trip Cost Matrix

Build a table showing total trip cost for each strategy.

For each booking strategy, calculate total = outbound + return + hotel:

StrategyOutboundReturnHotel (4 nights)TotalPoints UsedCash Out of Pocket
All cash$4,200$3,800$1,200$9,2000$9,200
Flights: award, Hotel: cash$120 tax$95 tax$1,200$1,415110,000 UR$1,415
Flights: award, Hotel: FHR$120 tax$95 tax$8,284 (paid via points)$8,499110,000 UR + 828,400 MR$215
Flights: Chase portal, Hotel: Edit———varies540,000 UR$0
Flights: award, Hotel: Airbnb$120 tax$95 tax$780$995110,000 UR$995
Step 4: Calculate Value Scores

For each strategy, compute:

Points value = (all-cash total - cash out of pocket) / total points used × 100

This tells you the CPP you're getting across the whole trip, not just one component.

Example:

"Flights: award + Hotel: Airbnb"
All-cash equivalent: $9,200
Cash out of pocket: $995
Points saved: $9,200 - $995 = $8,205
Points used: 110,000 UR
Trip CPP: $8,205 / 110,000 × 100 = 7.5 cpp
Step 5: Present the Trip Plan
Show full SKILL.md (393 more words)Show less
Trip: SFO → Paris, Aug 11-15, 2 adults, Business Class

✈️ Outbound: SFO → CDG, Aug 11

OptionSourcePrice/PointsCurrency
Cash (lowest)Duffel$4,200—
Flying Blueseats.aero55,000 + $120 taxChase UR (1:1)
Chase Portal Boostchase-travel180,000Chase UR

✈️ Return: CDG → SFO, Aug 15

OptionSourcePrice/PointsCurrency
Cash (lowest)Duffel$3,800—
Aeroplanseats.aero70,000 + $200 taxChase UR (1:1)

🏨 Hotels: Paris, Aug 11-15 (4 nights)

OptionSourcePer NightTotalPointsBenefits
SO/ Paris [EDIT]Chase$639$2,555127,756 URBreakfast, $100 credit
Le Bristol [FHR]Amex$1,849$8,284828,400 MR$100 credit, breakfast, upgrade
Marriott ChampsSerpAPI$289$1,156——
Airbnb: Marais 2BRAirbnb$195$780—Kitchen

💰 Trip Total by Strategy

#StrategyTotal CashPointsCPPRating
1Award flights (FB+AC) + Airbnb$1,115125,000 UR6.5⭐ Best value
2Award flights + Chase Edit hotel$2,870252,756 UR2.5Good convenience
3All cash$8,1360—Baseline
4Chase portal flights + Edit hotel$0487,756 UR1.7Most points
5Award flights + FHR hotel$8,599125,000 UR + 828,400 MRMixedLuxury

🎯 Recommendation:

Award flights via Flying Blue (out) + Aeroplan (return) = 125,000 Chase UR for $8,000 worth of business class flights. That's 6.4 cpp. Excellent.

For the hotel: Chase Edit SO/ Paris gives breakfast + $100 credit for $2,555 (or 127,756 UR at 2.0 cpp via boost). The Airbnb is cheapest at $780 but no breakfast or hotel amenities.

Best overall: Award flights + Airbnb if you want max savings. Award flights + Chase Edit if you want the hotel experience with benefits.

Step 6: Source Status

Always report which sources succeeded and which failed:

✅ Duffel: 45 outbound, 38 return
✅ Ignav: 40 outbound, 35 return
✅ Seats.aero: 12 award options outbound, 8 return
✅ Chase Travel: 300 outbound flights, 21 hotels
✅ Amex Travel: 292 outbound flights, 17 hotels
✅ SerpAPI: 25 hotels
✅ Trivago: 30 hotels
✅ LiteAPI: 22 hotels
✅ Airbnb: 18 listings
✅ Google Flights: 52 outbound
⏭️ Southwest: skipped (no SFO-CDG service)

Error Handling

NEVER fail silently. If any sub-search fails, note it and continue with what you have.

If flights fail but hotels succeed (or vice versa), present what you have and note the gap:

❌ Seats.aero: API timeout. Award flight pricing unavailable.
    Trip totals shown are cash-only and portal-only. Retry seats.aero for award options.

If ALL sources fail for one component, say so:

❌ All hotel sources failed. Cannot calculate trip total. Fix hotel search, then rerun.

Limitations

  • Round-trip cash prices from Duffel/Ignav may be cheaper than two one-ways. Note when this is the case.
  • Award pricing is one-way. The combined outbound + return award cost is the correct comparison against a round-trip cash fare.
  • Hotel pricing may vary between portal and direct booking. Note significant differences.
  • Chase portal pricing is dynamic Points Boost (~1.5-2.0 cpp on select bookings, not a guaranteed floor). The historical static 1.5x multiplier is gone. Pull the actual quote.
  • Trip totals are estimates. Taxes, fees, and exchange rates can change actual booking costs.

© borski, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/travel-hacking-toolkit/skills/trip-planner of borski/travel-hacking-toolkit.

Open the folder on GitHubat commit db82131

Compare with similar skills

Trip Planner next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Trip Planner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trip Planner this skillborski/travel-hacking-toolkit688—~2.1kAutomated safety check: PassMIT
Flightsasgeirtj/system_prompts_leaks69k—~2.1kAutomated safety check: PassCC0-1.0
Plannerpenpot/penpot61k—~2.7kAutomated safety check: PassMPL-2.0
Flightscodewhale-hq/Codewhale41k—~258Automated safety check: PassMIT
Trip Plannermohitagw15856/pm-claude-skills1.4k—~989Automated safety check: PassMIT
Agent Plannerruvnet/ruflo74k2 repos~1.2kAutomated safety check: PassMIT

Similar skills

  • Flights

    asgeirtj/system_prompts_leaks

    Research, book, or manage flights, including check-in. An agent skill from asgeirtj/system_prompts_leaks.

    69k GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Planner

    penpot/penpot

    Read-only planning and architecture analysis — produce a structured implementation plan with task breakdown, acceptance criteria, sizing, and checkpoints.

    61k GitHub stars~2.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Flights

    codewhale-hq/Codewhale

    Track flights and look up status and schedules. An agent skill from codewhale-hq/Codewhale.

    41k GitHub stars~258 tokensUpdated yesterday
    Auto-check passed
  • Trip Planner

    mohitagw15856/pm-claude-skills

    Turn a destination, some dates, and your vibe into a realistic day-by-day trip itinerary — paced for real humans, with a packing list and a rough budget.

    1.4k GitHub stars~989 tokensUpdated yesterday
    Auto-check passed
  • Agent Planner

    ruvnet/ruflo

    Agent skill for planner - invoke with $agent-planner. An agent skill from ruvnet/ruflo.

    74k GitHub starsUsed in 2 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Agent Goal Planner

    ruvnet/ruflo

    Agent skill for goal-planner - invoke with $agent-goal-planner

    74k GitHub starsUsed in 3 repos~842 tokens
    Auto-check passed

More from borski/travel-hacking-toolkit

All 46 skills in this repo
  • Amex Travel

    borski/travel-hacking-toolkit

    Search Amex travel portal for cash prices, MR points pricing, IAP discounts, and FHR/THC hotel benefits via Patchright.

    688 GitHub stars~3.1k tokensUpdated 3 days ago
    Auto-check passed
  • Chase Travel

    borski/travel-hacking-toolkit

    Search Chase UR travel portal via Patchright for cash prices, points pricing, Points Boost offers, and Chase Edit hotel benefits.

    688 GitHub stars~2.8k tokensUpdated 3 days ago
    Auto-check passed
  • Deutsche Bahn

    borski/travel-hacking-toolkit

    Deutsche Bahn train schedules, journey planning, and departures across Germany and into neighboring countries (Austria, Switzerland, Netherlands, France, Belgium).

    688 GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Sutochno

    borski/travel-hacking-toolkit

    Search Sutochno.ru (СУТОЧНО.РУ), a Russian short-term apartment-rental platform where you book directly from owners and pay in rubles (Mir card / bank transfer).

    688 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • Ticketsatwork

    borski/travel-hacking-toolkit

    Search TicketsAtWork (EBG corporate perks) for hotels, theme park tickets, attractions, and rental cars via Patchright.

    688 GitHub stars~4.2k tokensUpdated 3 days ago
    Auto-check passed
  • Vrbo

    borski/travel-hacking-toolkit

    Search VRBO (Vrbo / Expedia Group) vacation rentals including entire homes, condos, and cabins via Patchright browser automation.

    688 GitHub stars~1.7k tokensUpdated 3 days ago
    Auto-check passed

Questions about Trip Planner

What does Trip Planner do?

Full trip planning orchestration. An agent skill from borski/travel-hacking-toolkit. Trip Planner is an agent skill from borski/travel-hacking-toolkit. Full trip planning orchestration.

When should I use Trip Planner?

Trip Planner fits situations like: the user says plan a trip; wants the complete picture for a destination.

How do I install Trip Planner in Claude Code?

Run `npx skills add borski/travel-hacking-toolkit --skill trip-planner -a claude-code`. Or copy the skill folder (plugins/travel-hacking-toolkit/skills/trip-planner in borski/travel-hacking-toolkit) into .claude/skills/trip-planner in your project. Claude Code loads it when a task matches its description.

How do I install Trip Planner in Codex?

Run `npx skills add borski/travel-hacking-toolkit --skill trip-planner -a codex`. Or copy the skill folder (plugins/travel-hacking-toolkit/skills/trip-planner in borski/travel-hacking-toolkit) into .agents/skills/trip-planner in your project. Codex loads it when a task matches its description.

Can I use Trip Planner in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borski/travel-hacking-toolkit --skill trip-planner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/trip-planner, .gemini/skills/trip-planner, .github/skills/trip-planner and .opencode/skills/trip-planner in your project.

What does Trip Planner need to run?

SKILL.md names no scripts, command-line tools or credentials: Trip Planner is instructions for the agent only.

Does Trip Planner access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Trip Planner safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Trip Planner use?

Trip Planner is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Trip Planner use?

About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Trip Planner?

Skills that share tags, products or a category with Trip Planner: Flights (asgeirtj/system_prompts_leaks, 69k stars), Planner (penpot/penpot, 61k stars), Flights (codewhale-hq/Codewhale, 41k stars) and Trip Planner (mohitagw15856/pm-claude-skills, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trip Planner?

borski (a GitHub user) maintains it in borski/travel-hacking-toolkit, which has 688 GitHub stars. The repository holds 46 skills in this directory. The repository was last updated on October 5, 2026.

Source: borski/travel-hacking-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.