agentsclimarketplace

Propose flight

Skill hec-ovi/agentickit/examples/travel/.pilot/skills/propose-flight

AI copilot for React apps. Reads your state, fills forms, confirms actions, calls your tools. Multi-agent, AI SDK 6 + AG-UI, markdown skills. MIT.

Install
npx -y skills add hec-ovi/agentickit --skill propose-flight

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Surface flight options as a picker the user chooses from. Mounts an inline UI in the chat (renderAndWait) and pauses until the user picks one or skips. Used during the Itinerary page; a flights specialist agent also exists at /agents.

SKILL.md

2.8 KB, as published. Nobody here has run it

Page scope

propose_flight is registered ONLY on the Itinerary page (URL pattern /trips/<tripId>/itinerary). The tool is mounted by the React component on that page; on every other page (Trips, Trip Detail, Packing, Booking, Preferences, Agents, Threads, Lab) it is NOT in the registry and a call will silently fail.

Before calling, read the registered context. If active_trip state is present and you can see the user is on the Itinerary page, proceed. If not, do NOT call. Instead reply: "Open the trip's Itinerary page first; I can propose flights from there." This redirection is the correct behavior; never invent fake results, never apologize for a tool error, never retry on a different name.

When to use

Call propose_flight when the user wants flight options AND you are on the Itinerary page. Typical phrasings:

  • "find me a flight from JFK to Lisbon on the 12th"
  • "what flights are there from LAX next Friday"
  • "show me morning flights"
  • "I need a return on Sunday"

Do NOT call when the user is asking ABOUT flights as a topic (prices in general, airline opinions). Answer in prose for those.

How to use

  1. Resolve the dates first. If the user said "the 12th" or "next Friday", call compute_relative_date to get a YYYY-MM-DD value. Never invent.
  2. Call propose_flight({ origin, destination, date, returnDate? }). The tool mounts an inline picker in the chat with 2-4 options. The agent loop pauses until the user picks one or skips.
  3. After the user picks, narrate the choice in one sentence and stop. The picker writes the chosen flight into trip state automatically.
  4. If the user skips, acknowledge and offer one alternative ("want me to widen the date range?").

Output expectations

The tool resolves with the picked option (or { skipped: true }). You do NOT need to emit prices, times, or details — the picker UI already showed them and the user just made a choice. One sentence acknowledging is enough.

Anti-patterns

  • Do NOT call propose_flight twice in a row without user input between.
  • Do NOT prompt the user to "describe the kind of flight you want" before calling — the picker IS the disambiguation.
  • Do NOT narrate every option in prose after the picker resolves; the user already saw them.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.