trip-log

Save and retrieve flight searches and booked trips as Markdown files in trips/logs/.

650|67|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/borski/travel-hacking-toolkit --skill trip-log
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trip-log
Source: https://github.com/borski/travel-hacking-toolkit/tree/main/plugins/travel-hacking-toolkit/skills/trip-log
Command: npx skills add https://github.com/borski/travel-hacking-toolkit --skill trip-log

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Travel research disappears after each session, forcing you to redo award searches and lose track of what was already analyzed or booked. This Skill persists flight searches, award analyses, and booked itineraries as structured Markdown files so past work becomes a searchable reference library.

Core Features & Use Cases

  • Structured Trip Journals: Writes each search or booking to trips/logs/ using a consistent naming convention (YYYY-MM-DD_ORIGIN-DEST_label.md) and a fixed frontmatter schema with status, cabin, dates, and points snapshots.
  • Status Lifecycle Tracking: Moves trips through researched, booked, completed, and cancelled states, adding booking details as trips progress.
  • History Retrieval: Uses grep commands to surface past trips by status, origin airport, or tags when planning connected travel.
  • Use Case: After researching a business class award to Tokyo, ask to log the trip; months later, query all unbooked researched trips from SFO to decide which to book next.

Quick Start

Ask the AI to log this flight search to your trip journal, or ask it to show all past trips with status researched.

Frequently Asked Questions about trip-log

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save a flight search for later reference?

Ask the AI to log the trip or save the search, and it writes a Markdown file to trips/logs/ named with the date, route, and a short label. The file captures award options, cash prices, points analysis, and recommendations in a fixed structure.

How do I find past trip searches I already ran?

Use grep against the trips/logs/ directory, for example grep -l "status: researched" trips/logs/*.md to list unbooked trips or grep -l "origin: SFO" to filter by departure airport. The skill documents these exact query patterns.

Does trip logging happen automatically after every search?

No, logging is opt-in. Entries are created only when you ask, when a booking is made on an already-logged trip, or after every search only if you have explicitly requested automatic logging.

Can I track a trip from research through booking?

Yes, the frontmatter status field moves through researched, booked, completed, and cancelled states. When booked, the skill adds a BOOKED section with carrier, miles or cash used, and booking date.

Is sensitive account data stored in trip logs?

No, the skill explicitly prohibits storing .env values or account numbers in trip logs. Files live in trips/logs/, which is gitignored, so they remain local and are never pushed upstream.