Skip to content
Back to search

travelwright

MarketplaceWorks with Claude CodeGitHub

Plans a family trip from the bookings in your email and writes a dated packing and logistics checklist (Claude Code plugin and Agent Skill)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/m4bwav--travelwright/badge.svg)](/listings/m4bwav--travelwright)

HTML

<a href="/listings/m4bwav--travelwright"><img src="/api/listings/m4bwav--travelwright/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

As a Claude Code plugin:

/plugin marketplace add m4bwav/travelwright /plugin install travelwright@travelwright

As a plain skill for any agent that reads Agent Skills (Copilot, Codex, Cursor and others), clone the repository and link `skills/travelwright` into the agent's skills folder.

The agent needs read access to your mail (the Gmail connector in Claude, for example) to find bookings. Drive and family notes are optional; without them it asks about each traveller once.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 8 lines
  1. {
  2. "name": "travelwright",
  3. "owner": { "name": "Mark Rogers" },
  4. "metadata": { "description": "A skill that plans a family trip from the bookings in your email and writes a dated packing and logistics checklist" },
  5. "plugins": [
  6. { "name": "travelwright", "source": "./", "description": "Reads bookings from email, hosts from Drive and travellers' needs from family notes, then writes a dated checklist with sourced local facts" }
  7. ]
  8. }
README.md · README · 58 lines
  1. # travelwright
  2. ![travelwright banner](.github/images/banner.jpg)
  3. A family trip plan built from what is already written down, not from a questionnaire. travelwright has your AI agent read the bookings in your email first (flights, hotel, rental car, rides, the confirmations your partner forwarded), the hosts' addresses in your Drive and each traveller's needs in your family notes. Then it writes a dated checklist: what to do today, carry-on, clothes, a section per person, and logistics.
  4. Local facts in the checklist (car-seat laws, airport rides, store hours) come with a link and the date they were checked. Anything it could not check is marked unverified. Forecasts more than a week out are not made up.
  5. ## What it catches
  6. - The hotel is not in the city you named. It reads where you actually sleep before planning around it.
  7. - Birthdays and US holidays that fall inside the trip.
  8. - Car seats by age and by the destination state's law, and where a rideshare or taxi can or cannot take a young child.
  9. - Controlled medicines abroad: amphetamine medicines are banned in Japan, and the UAE needs a permit or a declaration at arrival.
  10. - Rental car against rideshare, with the arithmetic shown, redone when you correct a fact.
  11. ## Install
  12. As a Claude Code plugin:
  13. /plugin marketplace add m4bwav/travelwright
  14. /plugin install travelwright@travelwright
  15. As a plain skill for any agent that reads Agent Skills (Copilot, Codex, Cursor and others), clone the repository and link `skills/travelwright` into the agent's skills folder.
  16. The agent needs read access to your mail (the Gmail connector in Claude, for example) to find bookings. Drive and family notes are optional; without them it asks about each traveller once.
  17. ## Quick start
  18. Ask your agent:
  19. - "Help me pack for our trip to Denver next week."
  20. - "Are we ready for Thanksgiving travel?"
  21. - "What do the kids need for the flight?"
  22. Behind the skill is `tw.py`, standard-library Python 3.9+, which you can also run yourself:
  23. ```
  24. python skills/travelwright/scripts/tw.py extract emails.json --people <people dir> -o trip.json
  25. python skills/travelwright/scripts/tw.py events trip.json --people <people dir>
  26. python skills/travelwright/scripts/tw.py render trip.json --people <people dir> -o packing-plan.md
  27. ```
  28. `extract` pulls flights, stays, rental cars and rides out of saved email JSON (Gmail connector output, raw Gmail API messages, or plain `{subject, from, date, body}`). `events` lists birthdays and US holidays inside the trip. `render` writes the checklist. Fields: [trip-schema.md](skills/travelwright/references/trip-schema.md).
  29. ## Privacy
  30. Your family's names, medicines, addresses and booking numbers stay on your machine: in the trips folder you choose and in `~/.travelwright` (set `TRAVELWRIGHT_HOME` to move it). The skill never writes them into its own files, and nothing is sent anywhere except through the connectors your agent already uses. A test checks the repository against a private list of terms you keep in `~/.travelwright/leak-terms.txt`, so your details cannot slip into a contribution.
  31. The email parsers are tested on made-up fixtures. Real confirmation emails vary; if one is misread, open an issue with the layout described (never the email itself).
  32. ## Tests
  33. TRAVELWRIGHT_HOME=~/.travelwright python -m unittest discover -s tests
  34. ## Licence
  35. MIT. See [LICENSE](LICENSE). Security reports: [SECURITY.md](SECURITY.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.