award-calendar
Find the cheapest award dates for a route over a date range. Searches seats.aero across all programs, groups by date, and shows a calendar grid of the best deals. Use when dates are flexible and you want to find the sweet spot.
npx skills add borski/travel-hacking-toolkit --skill award-calendar --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Award Calendar "When should I fly SFO to NRT on points?" answered with a calendar view. Searches seats.aero across a date range and presents a grid showing the cheapest award per day, per cabin. Highlights the best dates to fly. **This is an orchestration skill.** It tells the agent how to query seats.aero and format the results. No standalone script. ## When to Use - "When's the cheapest time to fly SFO to NRT in business on points?" - "Show me award availability for SFO-CDG in September" - "I'm flexible on dates. When should I fly?" - Any award search where dates are flexible ## When NOT to Use - Specific date search (use `seats-aero` directly) - Cash price calendar (use Google Flights "Date grid" or Skiplagged) - Hotel date flexibility (not supported here) ## Workflow ### Step 1: Search the Date Range Use the seats.aero cached search API with a date range. The API supports up to ~60 days per query. ```bash curl -s -H "Partner-Authorization: $SEATS_AERO_API_KEY" \ "https://seats.aero/partnerapi/search?origin_airport={ORIGIN}&destination_airport={DEST}&start_date={START}&end_date={END}&cabin={CABIN}" ``` **Parameters:** - `origin_airport`: Can be comma-delimited for nearby airpo
- When to Use
- When NOT to Use
- Workflow
- Step 1: Search the Date Range
- Step 2: Group by Date
- Step 3: Apply Transfer Partner Optimization
- Step 4: Present Calendar Grid
- Step 5: Additional Context
- Error Handling
- Limitations
curl -s -H "Partner-Authorization: $SEATS_AERO_API_KEY" \
What does the award-calendar skill do?
Find the cheapest award dates for a route over a date range. Searches seats.aero across all programs, groups by date, and shows a calendar grid of the best deals. Use when dates are flexible and you want to find the sweet spot.
How do I install it?
Run `npx skills add borski/travel-hacking-toolkit --skill award-calendar --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From borski/travel-hacking-toolkit, a repository with 611 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.