Files
Magnus Hedemark 3cd705f7e6 feat(skill): travel-guide section-end footers — field notes, next-up, ghost mark
Fills the white space between sections with a bottom-of-page footer per
section: a content-derived field note (first anchor failure mode, first day
alternative, practical recheck item, or first skip reason) when one exists, a
next-section line with the following section's number, and a faint ghost
route mark. Footers hug the page bottom via flex column + margin-top auto;
multi-page sections carry the footer at the end of the section. Sheets fill
the print page so the footer lands at the bottom instead of floating.

Field notes repeat model content in one line and never invent new plans;
sections with nothing worth saying render the next-up line only. QA gate,
editorial reference, SKILL.md, and README updated; test suite extended to
cover footer presence, next-section wiring, and field-note content.

AI assistance: implementation and tests drafted by Jasper (Hermes Agent),
design reviewed and approved by Magnus Hedemark.
2026-08-10 20:01:17 -04:00
..

travel-guide — Personalized Travel Dossiers

Turn a destination, a real traveler, and a few constraints into a considered travel dossier instead of a generic attractions list.

Why Install This Skill

Most itinerary tools optimize for coverage. This skill helps an agent design for fit: the pace, people, budget, interests, energy, and small details that make a trip feel like it belongs to the travelers.

It can produce a print-ready HTML dossier for PDF conversion, a responsive companion page, or both. The visual system is editorial by default: a darkened photographic cover with a route journey line, ghost section numbers, a color-coded day strip, pace and budget meters, a unified warm photo grade across anchor photos, and a bottom-of-page footer on each section that carries a field note, a next-section line, and a ghost route mark. It keeps current logistics and recommendations tied to sources, and it can create a sanitized edition for sharing without exposing exact dates, lodging, booking identifiers, or private notes.

What You Get

Path Purpose
SKILL.md The complete workflow and routing rules
references/ Intake, research, editorial, privacy, and rendering guidance
templates/trip-brief.json Structured content model and example source ledger
templates/dossier-outline.md Human-readable drafting outline
styles/travel-dossier.css Print and responsive visual system
assets/route-mark.svg Small reusable route/compass mark
scripts/validate-trip-brief.py Dependency-free content-model validator
scripts/render-travel-guide.py Self-contained dossier or companion HTML renderer
scripts/sanitize-trip-brief.py Shareable-edition redaction without changing the private source
evals/evals.json Portable output-quality cases

Quick Start

Work in a dedicated working folder so no artifacts land in your home directory or the skill directory. From this skill directory:

mkdir -p work
cp templates/trip-brief.json work/my-trip.json
# Fill the JSON with the actual trip, recommendations, and source ledger.
python3 scripts/validate-trip-brief.py work/my-trip.json --strict --json
python3 scripts/render-travel-guide.py work/my-trip.json \
  --mode dossier --output work/my-trip.html --json

Open work/my-trip.html in a print-capable browser and save it as PDF. For a companion page instead:

python3 scripts/render-travel-guide.py work/my-trip.json \
  --mode companion --output work/site/index.html --json

To create a shareable model first:

python3 scripts/sanitize-trip-brief.py work/my-trip.json \
  --profile shareable --output work/my-trip-shareable.json --json

Triggers

Load this skill when someone asks for a personalized itinerary, a trip brief, a travel field guide, a beautiful travel PDF, recommendations shaped by the travelers, a shareable travel page, or private/shareable versions of a trip plan.

Requirements

  • An Agent Skills-compatible agent host.
  • Current web access when the guide includes live hours, prices, events, transit, or booking information.
  • Python 3.8+ for the bundled scripts; they use only the standard library.
  • A print-capable browser or document renderer for PDF output. PDF conversion is intentionally kept outside the dependency-free HTML renderer.