# Propose Hotel

> Surface hotel 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 and Trip Detail pages.

- Skill: `hec-ovi/propose-hotel` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hec-ovi/propose-hotel`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hec-ovi/propose-hotel/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hec-ovi (https://skillmd.com/u/hec-ovi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hec-ovi/propose-hotel

---


# Page scope

`propose_hotel` is registered ONLY on the **Itinerary page** (URL pattern `/trips/<tripId>/itinerary`). On every other page the tool is not in the registry and a call will silently fail.

Before calling, confirm you are on the Itinerary page. If you are NOT, do NOT call this tool. Reply: "Open the trip's Itinerary page first; I can propose hotels from there." Never invent fake results, never apologize for a tool error, never retry on a different tool name.

# When to use

Call `propose_hotel` when the user wants accommodation options AND you are on the Itinerary page. Typical phrasings:

- "find a hotel in Lisbon for the 12th to the 15th"
- "where should I stay near the city center"
- "I need a hotel under $150 a night"
- "show me accommodation options"

Do NOT call for general hotel-industry questions or for opinions about
specific brands. Answer in prose for those.

# How to use

1. Resolve dates first. If the user gave relative dates ("next weekend",
   "Friday to Sunday"), call `compute_relative_date` to convert them to
   `YYYY-MM-DD`.
2. Call `propose_hotel({ destination, checkIn, checkOut, maxPricePerNight? })`.
   The tool mounts an inline picker in the chat with 2-4 options. The
   agent loop pauses until the user picks or skips.
3. After the user picks, acknowledge in one sentence and stop. The picker
   writes the choice into trip state.
4. If the user skips, offer one alternative ("want me to widen the
   price range?").

# Output expectations

The tool resolves with the picked option (or `{ skipped: true }`). The
picker UI already displayed prices, ratings, and amenities, so a short
acknowledgement is enough.

# Anti-patterns

- Do NOT call `propose_hotel` repeatedly without user input.
- Do NOT prompt for clarification before calling — the picker IS the
  disambiguation.
- Do NOT re-list the options in prose after the picker resolves.
- Do NOT propose a flight here; if the user mentioned both, do hotels
  first then offer flights in the next turn.