liteapi-hotels

Original：🇨🇳 Chinese

Translated

2 scriptsChecked / no sensitive code detected

Hotel booking assistant. Use this skill whenever a user asks about booking hotels, searching for accommodation, or making hotel reservations. Guides users through search → select → pay → confirm. No API key required from users.

2installs

Sourceryan-nnn/liteapi-hotels-skill

Added on2026-05-10

NPX Install

npx skill4agent add ryan-nnn/liteapi-hotels-skill liteapi-hotels

SKILL.md Content (Chinese)

View Translation Comparison →

Hotel Booking Assistant

Help users find and book hotels. All API calls go through the backend server.

Step 1 — Collect info

Ask only for the missing information:

City (e.g., Shanghai)
Country Code (automatically inferred, e.g., CN, JP, US, GB)
Check-in Date (YYYY-MM-DD)
Check-out Date (YYYY-MM-DD)
Number of Adults (default: 2)
Currency (CNY by default for Chinese users)

Step 2 — Search for Hotels

bash

python "[SKILL_DIR]/scripts/search.py" \
  --city "Shanghai" --country "CN" \
  --checkin "2026-06-01" --checkout "2026-06-03" \
  --adults 2 --currency "CNY"

Display the top 5 results:

1. Grand Hyatt Shanghai ⭐5
   ¥1,280/night · Deluxe King Room · Free cancellation available

2. Waldorf Astoria on the Bund ⭐5
   ¥2,100/night · Classic Room · Non-refundable

Ask the user to select a number.

Step 3 — Collect Guest Information + Lock Price

Ask for:

Full Name (first name + last name)
Email Address (to receive confirmation email)

Then run:

bash

python "[SKILL_DIR]/scripts/prebook.py" \
  --offer-id "OFFER_ID" \
  --first-name "Wei" --last-name "Zhang" \
  --email "zhang@example.com" \
  --hotel-name "Grand Hyatt Shanghai" \
  --room-name "Deluxe King Room" \
  --checkin "2026-06-01" --checkout "2026-06-03"

If

priceChanged

is true, inform the user of the new price and confirm whether to proceed.

Step 4 — Send Payment Link

Send the returned

paymentUrl

to the user:

✅ Room locked successfully!

Please click the link below to complete payment (valid for 10 minutes):
🔗 [Pay Now](https://your-backend.railway.app/pay/xxx)

Your reservation will be automatically confirmed after payment, and a confirmation email will be sent to your inbox.

No credit card information is required from the user — users enter their details on the secure page.

Step 5 — Completion

After the user makes the payment, they will receive a confirmation email, and no additional action is required from the AI.

If the user asks about the reservation status, advise them to check their email.

Error Handling

No hotels found → Suggest adjusting the city or dates
Price changed → Display the new price and ask if the user wants to proceed
Payment link expired → Re-run prebook.py to get a new link

Notes

For Chinese users, respond in Chinese by default, with CNY as the default currency
Confirm that guest information is correct before placing the order