search-hotel

Search hotels by destination, dates, and occupancy via travel-cli.

Updated May 5, 2026
One-click install
npx skills add https://github.com/travala/travel-skills --skill search-hotel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: search-hotel
Source: https://github.com/travala/travel-skills/tree/main/cli/skills/search-hotel
Command: npx skills add https://github.com/travala/travel-skills --skill search-hotel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Searching for the right hotel can be slow and manual when you need accurate availability, pricing, and the IDs required for subsequent booking steps.

Core Features & Use Cases

  • Hotel search by destination and dates: Finds matching hotels for a specific city/neighborhood and check-in/check-out window, tailored to what the user provided.
  • Practical booking inputs: Returns structured hotel data (including hotelId and a sessionId) that downstream skills use for room lookup and booking.
  • Common scenario coverage: Supports typical user intents like “find me a hotel in X,” “where can I stay near Y,” and “show me hotels for my family,” including occupancy strings and optional price/date constraints.
  • Use case: A user provides Tokyo and dates; the skill returns a ranked list of hotels with pricing and cancellation/refundability details so the agent can present options and proceed to room search or booking.

Quick Start

Ask: "Find hotels in Tokyo from 2026-05-01 to 2026-05-05 for 2 adults and show me the top 5 options."

Frequently Asked Questions about search-hotel

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for hotel availability and pricing for specific travel dates?

To search for hotel availability, specify a destination, check-in/check-out dates, and occupancy. The tool returns matching hotels with pricing, cancellation details, and a sessionId for booking workflows.

What do I need to find hotels near a specific location for my family?

Finding hotels near a location requires a destination, check-in/check-out dates, and an occupancy string like "2 adults." Optional pricing filters help narrow results to matching accommodations.

Can I filter hotel search results by occupancy and price constraints?

Yes, hotel search supports optional occupancy and pricing filters. This allows targeted queries like finding accommodations for a family while applying specific budget constraints to the results.

What information is returned when looking for hotels to stay at?

Hotel search returns structured data including a hotelId, booking-ready pricing fields, and a sessionId. These outputs are required for downstream room lookup and booking steps.

How do I proceed to room lookup after finding a matching hotel?

After finding a matching hotel, use the returned hotelId and sessionId to invoke downstream room lookup and booking skills. The search output is formatted specifically for these subsequent steps.

Does hotel search include cancellation and refundability details?

Yes, hotel search returns ranked options that include cancellation and refundability details. This allows agents to present accommodations with full pricing context before proceeding.