// Use when planning flights, comparing ticket prices, or asking about flight costs, airline fees, travel dates, or route options. Triggers on booking flights, cheap tickets, flight search, vé máy bay, săn vé rẻ, tối ưu chi phí bay, đặt vé, virtual interlining, or any flight-related cost question.
| name | travel-optimization-engine |
| description | Use when planning flights, comparing ticket prices, or asking about flight costs, airline fees, travel dates, or route options. Triggers on booking flights, cheap tickets, flight search, vé máy bay, săn vé rẻ, tối ưu chi phí bay, đặt vé, virtual interlining, or any flight-related cost question. |
A decision support system for flight ticket cost optimization. Coordinates 8 specialized skills to analyze every angle of flight pricing before you book.
API keys required as environment variables (optional — skills work in AI-knowledge mode without APIs):
AMADEUS_API_KEY + AMADEUS_API_SECRET — register at developers.amadeus.comKIWI_API_KEY — register at tequila.kiwi.com/portalShared API clients: scripts/amadeus_client.py, scripts/kiwi_client.py, scripts/normalize.py
Before running any analysis, gather this profile (ask only what's missing). See references/user-profile-schema.md for full schema.
REQUIRED:
- origin: IATA code or city name (e.g., HAN, "Hanoi")
- destination: IATA code or city name (e.g., SFO, "San Francisco")
- departure_date: target date or range
- passengers: number + types (adult/child/infant)
OPTIONAL (improves accuracy):
- return_date: one-way if empty
- flexibility: low (±2 days) | medium (±7 days) | high (±14 days)
- baggage: carry_on | checked_1 | checked_2
- booking_type: personal | corporate
- loyalty_programs: airline codes (e.g., VN, QR)
- risk_tolerance: conservative | moderate | aggressive
- cabin_class: economy | premium_economy | business | first
If user provides minimal input (e.g., "HAN to SFO next month"), infer defaults:
Run these two skills simultaneously:
skills/date-optimization/SKILL.md — find cheapest travel dates in ±5-14 day windowskills/flight-search/SKILL.md — search flights across Amadeus + Kiwi with virtual interliningPass optimal dates from skill 1 into skill 2 for refined results.
With search results in hand, run sequentially:
skills/route-optimization/SKILL.md — find cheaper hub-based routesskills/fee-analysis/SKILL.md — deconstruct hidden fees, re-rank by true costskills/deals-verification/SKILL.md — check available deals and promo codesBased on profile and context:
booking_type == corporate → Read skills/negotiation-email/SKILL.mdrisk_tolerance != conservative → Read skills/flexibility-analysis/SKILL.mdskills/hidden-city-strategy/SKILL.md (requires explicit user consent)Generate a consolidated comparison report:
advertised_price → true_total comparison[DIRECT] [1-STOP] [INTERLINING] [LCC] [LEGACY]For users who only need one specific skill:
| User Intent | Skill to Load |
|---|---|
| "When is cheapest to fly?" | skills/date-optimization/SKILL.md |
| "Find flights HAN→SFO" | skills/flight-search/SKILL.md |
| "Is there a cheaper route?" | skills/route-optimization/SKILL.md |
| "What's the real price with fees?" | skills/fee-analysis/SKILL.md |
| "Any promo codes?" | skills/deals-verification/SKILL.md |
| "Help me negotiate with airline" | skills/negotiation-email/SKILL.md |
| "Should I buy flexible ticket?" | skills/flexibility-analysis/SKILL.md |
| "Tell me about hidden city" | skills/hidden-city-strategy/SKILL.md |
references/amadeus-api.md — Amadeus Self-Service API endpoints and authreferences/kiwi-api.md — Kiwi Tequila API with virtual interliningreferences/airport-codes.md — Hub airports, alliances, strategic routing tipsreferences/user-profile-schema.md — Full profile field documentationUse when traveler has flexible dates and wants to find the cheapest departure/return combination. Triggers on cheapest day to fly, flexible dates, when to book, price calendar.
Use when looking for airline promo codes, flash sales, or credit card discounts before booking. Triggers on promo code, discount, sale, deal, coupon, cashback, loyalty discount.
Use when advertised flight price seems too good, or when comparing LCC vs legacy carrier total costs. Triggers on hidden fees, baggage cost, true price, real cost, checkout surprise.
Use when deciding between flexible and non-refundable tickets, or when travel plans might change. Triggers on refundable vs non-refundable, cancel risk, change fee, should I buy flexible ticket.
Use when searching for flights, comparing airlines, or finding virtual interlining combinations across multiple carriers. Triggers on find flights, search routes, compare airlines, best price.
Use when user explicitly asks about hidden city ticketing, skiplagging, or throwaway ticketing. Requires explicit consent before analysis. Triggers on hidden city, skiplag, get off at layover.