# Propose Flight

> |

- **Type:** Skill
- **Install:** `agentstack add skill-hec-ovi-agentickit-propose-flight`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hec-ovi](https://agentstack.voostack.com/s/hec-ovi)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [hec-ovi](https://github.com/hec-ovi)
- **Source:** https://github.com/hec-ovi/agentickit/tree/main/examples/travel/.pilot/skills/propose-flight

## Install

```sh
agentstack add skill-hec-ovi-agentickit-propose-flight
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Page scope

`propose_flight` is registered ONLY on the **Itinerary page** (URL pattern `/trips//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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hec-ovi](https://github.com/hec-ovi)
- **Source:** [hec-ovi/agentickit](https://github.com/hec-ovi/agentickit)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hec-ovi-agentickit-propose-flight
- Seller: https://agentstack.voostack.com/s/hec-ovi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.