← WinCloudCONTENT HISTORY

Update to WinCloud

Snapshot Nov 15, 2026 · 18:11 UTC · version 0.1.0

Collection source: downloaded plugin package.

WHAT CHANGED

First saved snapshot

No earlier snapshot is available to establish a change.

Save WinCloud and check future changes in Following.

Up to 3 plugins free · no card required.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Use when a user asks about their hotel's data in WinCloud, such as bookings, arrivals, departures or cancellations, one reservation in detail, booking pace and demand, room types, rooms and features, rate plans, nightly tariffs and how rates are derived, rooms occupied or vacant today, or a guest's profile and stay history. Also use for any request for stats, summaries, insights, charts, KPIs, reports, forecasts or analysis about that data. Explains which WinCloud tool answers which question, the order to call them in, and what the tools cannot do.",
  "included_files": [],
  "name": "wincloud",
  "skill_md_contents": "---\nname: wincloud\ndescription: Use when a user asks about their hotel's data in WinCloud, such as bookings, arrivals, departures or cancellations, one reservation in detail, booking pace and demand, room types, rooms and features, rate plans, nightly tariffs and how rates are derived, rooms occupied or vacant today, or a guest's profile and stay history. Also use for any request for stats, summaries, insights, charts, KPIs, reports, forecasts or analysis about that data. Explains which WinCloud tool answers which question, the order to call them in, and what the tools cannot do.\n---\n\n# Using WinCloud\n\n**Every answer that summarises numbers (counts, totals, trends, comparisons, KPIs) follows `wincloud-report-format`: headline, KPI row, a real chart, then a detail table, and the user does not have to ask for the chart. When they say \"all locations\", use every location `list_companies` returns and show them side by side in one chart. Never answer such a question with bullets or a table alone. Lists of individual bookings or guests are the exception: a table.**\n\nWinCloud is a hotel property management system. Its tools read one property location's (one hotel's) data at a time. They are read-only today: they never create, change or cancel anything, and they never return payment details.\n\n## Before any call: the location\n\nEvery tool needs a `companyId`, the WinCloud code of one property location, that is one hotel (for example `WS`). WinCloud calls locations \"companies\", so say \"hotel\" or \"location\" to the user. The codes are internal ids: never show a bare code to the user.\n\n1. **Resolve names first, once per conversation.** Before the first answer that mentions a hotel, call `list_companies` and keep the map of code to name (for example `WS` → Grand Hotel), with each hotel's currency and room count. Do this even when the `companyId` description already lists codes, because that list has codes only.\n2. **Choosing a hotel:** if there is only one location, use it without asking. If there are several and the user didn't name one, ask with the hotel names as the options (\"Grand Hotel\", \"Western Hotel\", \"Both\"), not the codes, or call the tool once per location when they asked about all of them.\n3. **Matching what the user says:** match a hotel the user names (\"Grand\", \"the Western\") to its code with the map. Never guess a code; the `WS` in the description is only an example.\n4. If a call fails with an access error, name the hotel, say the user can't see it, and offer the ones they can, by name.\n\n**Naming rule for every answer:** call each location by its `list_companies` name in headlines, KPI labels, chart titles, legends, axis labels, tables, attention lists and questions. The code may appear once, in brackets in \"Basis and caveats\" (for example \"Grand Hotel (WS)\"), so the manager can find it in WinCloud. If `list_companies` is unavailable or returns no name, use the code and say the name couldn't be retrieved.\n\n## Which tool answers which question\n\n| The user wants… | Tool |\n|---|---|\n| Bookings made, arriving, departing or cancelled over a period, by status, number or guest name | `search_bookings` |\n| One reservation in full: rooms, times, rate plan, source, OTA reference, cancellation reason | `get_reservation` |\n| Booking pace, lead times, ADR, cancellations or no-shows | `get_reservation_analytics` |\n| The room types, rate types and rate plans a hotel sells, and the channels it sells through | `get_rate_plans` |\n| Prices and restrictions (stop-sell, closed to arrival or departure, minimum or maximum stay) for dates | `search_room_tariffs` |\n| Room types with their room counts and base prices | `list_room_types` |\n| The master rates other rates are derived from | `list_master_rates` |\n| How a derived rate is calculated from its master rate | `get_rate_configuration` |\n| When each set of rate formulas applies (days, seasons) | `list_rate_templates` |\n| The physical rooms: numbers, floors, beds | `list_rooms` |\n| The room features (amenities) the hotel has set up | `list_room_features` |\n| How many rooms are occupied or vacant right now | `get_inventory` |\n| Find a guest's profile, email or mobile | `search_guests` |\n| A guest's past and upcoming stays | `get_guest_reservations` |\n| Which hotels (property locations) the user can see | `list_companies` |\n\n**One guest or many?** For one guest's whole stay history, use `search_guests` then `get_guest_reservations`. For arrivals, departures, in-house guests or cancellations across the hotel, use `search_bookings`: today's arrivals are `arrivalFrom` and `arrivalTo` set to today, in-house guests are status `CheckedIn`.\n\n## Analysis, forecast and report questions\n\nThese have their own skills. Load the one that fits, then answer as `wincloud-report-format` says.\n\n| The user wants… | Skill |\n|---|---|\n| A period review, report or comparison across hotels or periods | `wincloud-performance-review` |\n| Today's picture: arrivals, departures, how full now | `wincloud-daily-briefing` |\n| How full the hotel will be, weak dates, rooms left to sell | `wincloud-occupancy-forecast` |\n| Booking pace, pickup, lead time, ahead or behind last year | `wincloud-pickup-pace` |\n| Cancellations, no-shows, how late guests cancel | `wincloud-cancellations` |\n| ADR, pricing performance, indicative RevPAR | `wincloud-adr-revpar` |\n\n## Call them in the right order\n\n- **Prices for a room and rate:** call `get_rate_plans` first to get the exact room type and rate type ids, then pass those ids to `search_room_tariffs`. Don't pass a room name such as \"Deluxe\" as an id.\n- **A guest's stays:** call `search_guests` first (by name, email or mobile, at least 3 characters), then pass the guest id it returns to `get_guest_reservations`. If several guests match, show them and ask which one.\n- **One booking in detail:** if the user doesn't know the number, find it with `search_bookings`, then call `get_reservation`.\n- **How a rate is built:** `list_master_rates` and `list_rate_templates` give the ids, `get_rate_configuration` gives the adjustments. For the resulting prices, use `search_room_tariffs`.\n\n## Dates\n\n- Send dates as `yyyy-MM-dd`, and the end date must not be before the start date.\n- Turn relative dates (\"this month\", \"next week\") into exact dates yourself, and say which range you used.\n\n## Limits to respect\n\nSay plainly when a question falls outside these limits instead of answering it with the wrong tool.\n\n- **`search_bookings` date pairs each filter their own date.** `startDate` and `endDate` are the date the booking was made; use `arrivalFrom`/`arrivalTo`, `departureFrom`/`departureTo` or `cancelledFrom`/`cancelledTo` for the others, and say which one you used.\n- **In `get_reservation_analytics` bookings rows, count rooms as booked plus availed.** Reservations that have already happened come back as `0 room(s) booked, 1 availed`, so booked alone gives 0 for any past period. Use booked + availed as a row's rooms, and say you did. A negative \"day(s) ahead\" means it was booked after the arrival date.\n- **`get_reservation_analytics` returns rows, not totals.** Each row is one reservation, dated by its arrival date, not one row per night; add them up across pages for totals, and say if you stopped before the last page. Its date filter means the booking date for bookings, the cancellation date for cancellations and the arrival date for no-shows.\n- **`get_rate_configuration` describes formulas, not prices.** A missing adjustment means none is set, not 0.\n- **`list_room_features` can't say which rooms have a feature**, and `list_rooms` shows WinCloud's room status code as stored, not today's occupancy.\n- **Questions about stays or arrivals in a period** (\"ADR for February stays\", \"cancellations for January arrivals\"): `get_reservation_analytics` filters bookings by booking date and cancellations by cancellation date, but every row carries its arrival date. Read a booking or cancellation range wide enough to cover those arrivals (for example the 12 months before the period's end), keep only rows arriving in the period, and say you did.\n- **`get_inventory` is today only.** It can't show availability on future dates, and tariffs are not availability.\n- **`get_inventory` counts may not add up.** When occupied plus vacant is less than total rooms, report the difference as \"other or unavailable (for example out of order)\" and say WinCloud doesn't give the reason. Never fold it into vacant or occupied.\n- **`search_room_tariffs` does not include weekend tariffs.**\n- **\"Standard price\" is not a WinCloud term.** A hotel sells several rate plans. When the user says \"standard\", \"normal\" or \"rack\" price, list the rate plans from `get_rate_plans` and ask which one, or pick the one named BAR or Regular Rate and say which plan you used.\n- **Guest email and mobile come only from `search_guests`.** Bookings, reservations and a guest's reservation list don't include them. If a guest's profile has none, say so; never invent one.\n- **Read-only.** If asked to book, change or cancel something, say this has to be done in WinCloud itself.\n- **A tool may be missing.** Each tool except `list_companies` needs a permission on the user's sign-in. If the tool for a question isn't available, say the user's account doesn't have that permission yet and suggest they ask their administrator, then sign in again. Use another tool only if it really answers the question (such as `search_bookings` by guest name), and say what it can't show.\n\n## Paging\n\nResults come a page at a time (20 by default, up to 50). Ask for 50 a page.\n\n- **Summary questions** (\"find bookings\", \"how many\", \"bookings by month\", a trend or a comparison): read every page before answering, up to 15 pages per location, then show the headline, KPI row and chart from `wincloud-report-format`. Don't stop at page 1 and offer to continue. If there are more than 15 pages, say the figures cover only what you read.\n- **List questions** (\"list\", \"show me the bookings\", one guest's stays): show the first page as a table and say there are more pages.\n\n`get_rate_plans` isn't paged: it shows at most 100 rate plans and says when the rest are not listed. Room types and rate types are always listed in full, so pass those ids to `search_room_tariffs` for a specific room type and rate type.\n\n## Answering\n\n- **Start with a one-sentence summary, in every response:** the count, the total, the trend or the yes or no, in at most 25 words. This holds for lists, lookups and \"can't do that\" answers too.\n- **Then show the detail as `wincloud-report-format` says:** load it for any answer with more than one number. Use a table for lists of bookings, guests, room types or prices, and plain text for a single fact.\n- Report only what the tools returned. Don't fill gaps with estimates.\n- Use the hotel's own names for room types and rate plans, as the tools return them.\n- Say \"pricing\" or \"rates\" to the user rather than \"tariffs\".\n"
}

SHA-256 of public snapshot: 295aeb80dd68976e9c06ae7a63117ef230ebe3e824fb6a80017544c591d7326e