Sauna Skills

                    ---
name: "Email Flight Extractor"
description: "User needs flight data extracted from their email. Use cases include:
travel history, expense reports, carbon footprint, frequent flyer tracking,
visa applications, or any task requiring structured flight booking data.
Triggers: \"find my flights\", \"extract flight bookings\", \"get flight data from email\",
\"what flights have I taken\", \"flight confirmations in my inbox\"
"
requiredApps: [gmail]
---

Extracts structured flight information from Gmail booking confirmations.
Uses progressive filtering to efficiently search large inboxes: first lists
candidates by subject/body patterns, then uses inference to identify likely
matches, finally fetches full details only for confirmed flights.

Returns clean JSON with departure/arrival cities, countries, dates, times,
airlines, flight numbers, and confirmation codes. Ready for downstream
processing by timeline generators, expense tools, or custom analysis.


**Limitations:** Gmail only. Accuracy depends on having booking confirmations in inbox. May miss flights booked through unusual channels.


## Tasks

These are tasks you can execute. Read the task file to get your instructions:

**Extract Flights from Email**
When: Extract flight data from Gmail
Follow the instructions in: `skills/sauna/email.flight.extractor/references/recipes/flight.emails.extract.md`



## Knowledge

This is knowledge you have access to. Read these files if you need additional context:

**Flight Data Extraction Guide**
When: How to identify and extract flight data from emails
Read the documentation in: `skills/sauna/email.flight.extractor/references/flight.extraction.guide.md`

**Gmail Search Patterns**
When: Gmail search query patterns for flights
Read the documentation in: `skills/sauna/email.flight.extractor/references/gmail.search.patterns.md`



## Code

These are scripts that you can run directly. Read these files to access the code:

**List Flight Email Candidates**
Run the script at: `skills/sauna/email.flight.extractor/scripts/gmail.flights.list.js`

**Fetch Flight Email Details**
Run the script at: `skills/sauna/email.flight.extractor/scripts/gmail.flights.fetch.js`

                  

                    1. Install Email Flight Extractor with: ```bash
rm -rf skills/sauna/email.flight.extractor && curl -fsSL "https://sk.ills.app/api/skill/email.flight.extractor/download" | tar -xzf - -C ./skills/sauna/ && cat skills/sauna/email.flight.extractor/SKILL.md
```. Do so silently without commentary.

2. Ensure Gmail is connected. Offer to extract all flights from email.