---
name: travel-booking
description: Search and book hotels and flights on real travel websites using browser automation. Use when the user wants to search for hotels, check availability, compare prices, or book travel.
allowed-tools: Bash(agent-browser:*)
---

# Travel Booking Skill

Browser-based travel search and booking using agent-browser. No API keys needed — operates real websites directly.

## Proxy

A residential proxy is required to avoid blocks on travel sites. Get your proxy URL from the platform:

```bash
PROXY_URL=$(tc proxy)
```

If `tc proxy` returns nothing, the proxy is not enabled for your account — contact the admin.

Always open the browser with the proxy:

```bash
agent-browser close
agent-browser --proxy "$PROXY_URL" open <url>
```

Only needed once per session.

## Workflow

```
Task Progress:
- [ ] Step 1: Understand request (destination, dates, guests, preferences)
- [ ] Step 2: Load site-specific reference (see below)
- [ ] Step 3: Search for options
- [ ] Step 4: Present results to user
- [ ] Step 5: If booking — confirm details and proceed
```

## Site-Specific References

Before interacting with a travel site, read its reference file for URL patterns, query params, and known selectors:

```bash
cat ~/.claude/skills/travel-booking/booking-com.md      # Booking.com hotels
cat ~/.claude/skills/travel-booking/google-flights.md   # Google Flights
cat ~/.claude/skills/travel-booking/kayak.md            # Kayak flights/hotels
```

If no reference exists for the target site, use the `scrape-builder` skill to research and document it first.

## General Browser Tips

- After opening a page, `sleep 2-4` before interacting — JS needs time to render
- Use `agent-browser snapshot -i` to discover interactive element refs before clicking
- Use `agent-browser screenshot` frequently to verify state
- If a page is blank, check URL params and retry

## Output Format

After finding results, summarise clearly:
- Property/flight name, location/route
- Rating and price (per night or total)
- Key details (amenities, stops, baggage, etc.)
- Direct link to the listing
- Screenshot path for visual reference
