Agent skill

Plan Trip

by borski in borski/travel-hacking-toolkit

Guided trip planning workflow. An agent skill from borski/travel-hacking-toolkit.

MITAuto-check passed

Install Plan Trip

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

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

GitHub CLI
$ gh skill install borski/travel-hacking-toolkit plan-trip --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/plan-trip .claude/skills/plan-trip && 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
plan-trip
GitHub stars
688
Token cost
~1.1k tokens
SKILL.md length
624 words
Files
1
Skills in repo
46
Repo updated
First seen
Licence
MIT

At a glance

Guided trip planning workflow. An agent skill from borski/travel-hacking-toolkit.

  • Works in 6 steps: Where? Destination(s). Accept regions… → When? Departure month or date range.… → Who? Number of travelers, ages if… → …
  • SKILL.md covers How to run this, The workflow, Hotels and ground transit and Output style, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Plan Trip is an agent skill from borski/travel-hacking-toolkit. Guided trip planning workflow. Asks destination, dates, travelers, class, and flexibility, then runs parallel flight/hotel search with cpp math and booking plan.

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

It works with C++. 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.

Example prompts

  • “/plan-trip”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Where? Destination(s). Accept regions ("Scandinavia"), cities ("Tokyo"), or specific airports.
  2. When? Departure month or date range. Note flexibility: "exact dates" vs "any week in March" matters a lot for award availability.
  3. Who? Number of travelers, ages if children/infants. The toolkit supports infant pricing and seat configurations.
  4. What class? Economy / premium economy / business / first. Default to economy if unstated.
  5. Trip length? Number of nights at destination if applicable.
  6. Points or cash? Three valid answers: "best of both" (default), "points only" (treat cash as last resort), "cash only" (skip award search).

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

Plan Trip loads about 1.1k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 624 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~1.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). 624 words, ~1,149 tokens.

Download SKILL.mdSave it as .claude/skills/plan-trip/SKILL.md (or your agent's skills folder).
name
plan-trip
description
Guided trip planning workflow. Asks destination, dates, travelers, class, and flexibility, then runs parallel flight/hotel search with cpp math and booking plan.
disable-model-invocation
true
category
orchestration
summary
Guided trip planner. The hero command for the toolkit.
license
MIT

Plan Trip Skill

The user invoked this skill explicitly. Run a guided trip planning workflow that produces a concrete, opinionated recommendation with cents-per-point math, transfer paths, and a booking plan.

How to run this

If the user already gave details in their prompt arguments, use those. Otherwise, ask in this order, one question at a time. Don't fire all the questions at once.

  1. Where? Destination(s). Accept regions ("Scandinavia"), cities ("Tokyo"), or specific airports.
  2. When? Departure month or date range. Note flexibility: "exact dates" vs "any week in March" matters a lot for award availability.
  3. Who? Number of travelers, ages if children/infants. The toolkit supports infant pricing and seat configurations.
  4. What class? Economy / premium economy / business / first. Default to economy if unstated.
  5. Trip length? Number of nights at destination if applicable.
  6. Points or cash? Three valid answers: "best of both" (default), "points only" (treat cash as last resort), "cash only" (skip award search).

After question 6, confirm the plan back to the user in one sentence and start the workflow.

The workflow

Once you have the inputs:

  1. Load lessons-learned first. Non-optional. Other skills depend on it.
  2. Load flight-search-strategy for the canonical parallel search plan.
  3. Pull balances via the awardwallet skill if the user's intent is points or "best of both" AND if balances aren't already in this session's context. Skip the pull if you already know them.
  4. Run cash search in parallel via duffel, ignav, google-flights, and the relevant free MCPs (Skiplagged, Kiwi).
  5. Run award search in parallel via seats-aero across ALL programs (never filter to one program upfront — see lessons-learned).
  6. Cross-reference with transfer-partners and transfer-bonuses to find the cheapest currency you actually have.
  7. Apply points-valuations to compute cents-per-point on each award option.
  8. Surface anything from award-sweet-spots that matches this route.
  9. Check stopovers if the destination involves a connection. Multi-city trips might unlock "two destinations for the price of one" via Aeroplan, Alaska, or Flying Blue.
  10. Show the math in a markdown table. One row per option, ranked. Columns: program, miles cost, cash co-pay, total $ value, cpp, hold-before-transfer rule, recommendation.
  11. Pick a winner with one-sentence reasoning.
  12. Show booking next steps via booking-guidance: which program to call, hold rules, transfer timing, phone numbers if needed.
Show full SKILL.md (243 more words)Show less

Hotels and ground transit

If the trip is more than just flights, mention these as available next steps in your closing summary (not as a question):

  • Hotels via compare-hotels (FHR/THC/Edit/Booking/Trivago/Airbnb/TaW)
  • Stopover side trips via stopovers + the relevant transit skill (scandinavia-transit for Norway/Sweden/Denmark, deutsche-bahn for Germany / Austria / Switzerland / Netherlands / France / Belgium)
  • Atlas Obscura suggestions for unique places at the destination
  • Airport route sanity check via wikipedia-airports if the user asks about an obscure carrier or regional service

Don't dump all of these at once. Lead with the flight recommendation. Mention hotels/activities as concrete follow-up actions the user can ask for next.

Output style

  • Markdown tables for results
  • Bold the winning option
  • Always show cpp on award redemptions
  • Cite the source skill for each piece of data ("via seats-aero", "via awardwallet")
  • End with a "Next steps" section listing concrete follow-up commands the user can issue. Examples: "Next steps: I can check specific dates around X, search hotels at Y, look up sweet-spot redemptions you're not using." This must be a declarative statement, NOT a question. Don't write "Want me to..." or "Should I..." (the system prompt's PRE-OUTPUT GATE bans those patterns).

Don't do this

  • Don't dump 12 options. Pick 3-5 and rank.
  • Don't assume the user has every API key. If a key is missing, say so and tell them what's still searchable. Cash flights work without any keys at all.
  • Don't transfer points speculatively. The booking-guidance skill enforces "hold before transfer" rules. Respect them.

© 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/plan-trip of borski/travel-hacking-toolkit.

Open the folder on GitHubat commit db82131

Compare with similar skills

Plan Trip 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.

Plan Trip compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plan Trip this skillborski/travel-hacking-toolkit688—~1.1kAutomated safety check: PassMIT
Paddle BuildPaddlePaddle/Paddle24k—~1kAutomated safety check: PassApache-2.0
Fory Releaseapache/fory4.6k—~2.9kAutomated safety check: PassApache-2.0
ONNX Runtime Shape Inference Safety Auditmicrosoft/onnxruntime22k—~3.3kAutomated safety check: PassMIT
Code Audit3stoneBrother/code-audit8931 repos~2.7kAutomated safety check: PassNone
Qt C++ Code Reviewx-tools-author/x-tools1.1k2 repos~4.3kAutomated safety check: PassBSD-3-Clause

Similar skills

  • Paddle Build

    PaddlePaddle/Paddle

    A skill your agent uses when needing to compile, rebuild, or install Paddle from source after code changes.

    24k GitHub stars~1k tokensUpdated 8 days ago
    AI & LLM EngineeringAuto-check passed
  • Fory Release

    apache/fory

    Prepare an Apache Fory release candidate from a clean release branch, including the version bump, RC tag, JVM staging, ASF source artifacts, SVN upload, and vote email.

    4.6k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Official

    Finds and fixes out-of-range output writes in ONNX Runtime operator shape-inference functions where a getNumOutputs guard admits too few outputs.

    22k GitHub stars~3.3k tokensUpdated today
    SecurityAuto-check passed
  • Code Audit

    3stoneBrother/code-audit

    Professional code security audit skill covering 55+ vulnerability types.

    893 GitHub starsUsed in 1 repo~2.7k tokens
    SecurityAuto-check passed
  • Qt C++ Code Review

    x-tools-author/x-tools

    Read-only review of Qt6 C++ code that combines a deterministic lint script with six parallel analysis agents and reports only high-confidence issues.

    1.1k GitHub starsUsed in 2 repos~4.3k tokens
    DevelopmentAuto-check passed
  • Translation

    doxygen/doxygen

    Keeps all Doxygen and Doxywizard translations up to date across three mechanisms: translator C++ classes (src/translatorxx.h), Qt .ts locale files for the Doxywizard GUI (addon/doxywizard/i18n/)…

    6.6k GitHub stars~5.2k tokensUpdated 7 days ago
    Writing & ContentAuto-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 2 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 2 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 2 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 2 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 2 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 2 days ago
    Auto-check passed

Works with

Questions about Plan Trip

What does Plan Trip do?

Guided trip planning workflow. An agent skill from borski/travel-hacking-toolkit. Plan Trip is an agent skill from borski/travel-hacking-toolkit. Guided trip planning workflow.

How do I install Plan Trip in Claude Code?

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

How do I install Plan Trip in Codex?

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

Can I use Plan Trip 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 plan-trip -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/plan-trip, .gemini/skills/plan-trip, .github/skills/plan-trip and .opencode/skills/plan-trip in your project.

What does Plan Trip need to run?

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

Does Plan Trip 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 Plan Trip 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 Plan Trip use?

Plan Trip is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Plan Trip use?

About 1.1k tokens (SKILL.md is roughly 4.6k 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 Plan Trip?

Skills that share tags, products or a category with Plan Trip: Paddle Build (PaddlePaddle/Paddle, 24k stars), Fory Release (apache/fory, 4.6k stars), ONNX Runtime Shape Inference Safety Audit (microsoft/onnxruntime, 22k stars) and Code Audit (3stoneBrother/code-audit, 893 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plan Trip?

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.