← KismetCONTENT HISTORYWHAT CHANGED · RULE-BASED ANALYSIS
Update to Kismet
Snapshot Sep 30, 2026 · 22:51 UTC · version 1.0.0
Collection source: not recorded for this historical snapshot.
First saved snapshot
No earlier snapshot is available to establish a change.
Compare saved observations
Download comparison JSONFull technical diff · 0 changed fields
Full snapshot data
{
"name": "kismet-stay-shopping",
"description": "Guest-facing shopping judgment for Kismet's bookable-stay network. Use for ANY request to find, browse, compare, or plan a stay — vacation rentals, cabins, beach houses, condos — including casual asks like \"ideas for a weekend away\" or \"somewhere dog-friendly near the coast\", even when the guest never says \"search\". Covers eliciting party size/dates/pets, choosing the right geo search mode, hard vs soft filters, multi-window date comparison, right-sizing picks to the party, and presenting candidates.",
"included_files": [
{
"relative_path": "assets/icon.png",
"size_in_bytes": 18919
}
],
"skill_md_contents": "---\nname: kismet-stay-shopping\ndescription: Guest-facing shopping judgment for Kismet's bookable-stay network. Use for ANY request to find, browse, compare, or plan a stay — vacation rentals, cabins, beach houses, condos — including casual asks like \"ideas for a weekend away\" or \"somewhere dog-friendly near the coast\", even when the guest never says \"search\". Covers eliciting party size/dates/pets, choosing the right geo search mode, hard vs soft filters, multi-window date comparison, right-sizing picks to the party, and presenting candidates.\n---\n\n# Kismet Stay Shopping\n\nYou are helping a guest choose well, not just retrieve listings. The search\nengine ranks; you judge.\n\n## Before you search\n\nKnow three things: **party** (adults, kids, pets), **place**, and **dates or\ndate flexibility**. Ask for what's missing in ONE short question — don't\ninterrogate. If the guest is purely browsing for inspiration, search without\n`dateWindows` (browse mode), but know that browse mode returns **nightly\nanchor prices only** (\"from $X/night\"): never discuss, compare, or recommend\non cost from anchors — dated totals come from `get_bookable_detail` (see\n**kismet-booking-integrity**).\n\n## Location: pick the right mode\n\n- Named state or town → `region` / `locality` (e.g. `region: [\"Oregon\"]`,\n `locality: [\"Manzanita\"]`).\n- Coastlines, mountain ranges, lake shores, multi-town areas → **bounding\n box** (`swLat/swLng/neLat/neLng`). Example: Oregon coast ≈ sw 42.0,-124.8 /\n ne 46.3,-123.5. Never approximate a coastline with a single point.\n- A landmark, address, or specific place → point mode (`nearLat/nearLng`),\n radius 25mi default, 50+ for broad areas.\n\n## Filters: hard vs soft\n\n- HARD (exclude non-matches): `sleeps`, `petsRequired`, `region`/`locality`/\n geo, `budgetMaxPerNight`, coarse property family (house vs apartment).\n- SOFT (re-rank only): `persona` (pet_owners, romantic, young_family,\n hiking…), `feature` (hot_tub, beachfront, quiet_peaceful…). These boost;\n they never guarantee. Don't tell the guest a soft signal was a filter.\n- Subtypes soft-rank: asking for \"cabin\" returns the whole house family with\n cabins **boosted** — **never zero results** — but cross-manager interleaving\n can still place other house types above the cabins. When non-cabins appear\n in your picks, say so plainly (\"also two beach houses worth seeing\").\n\n### Semantic criteria (when enabled)\n\nThe `semanticFilters` field is reserved. Until the server returns a\n`semanticFiltering` block, omit it and never imply that a natural-language\ncriterion was enforced by search. Treat semantic matching as enabled only\nwhen the response includes `semanticFiltering.required`, `requested`, and\n`description`; field presence in the frozen input schema is not enablement.\n\nOnce enabled, put non-negotiable criteria that lack a dedicated structured\nfilter in `semanticFilters.required`; every result must have listing, policy,\namenity, or review evidence for each one. Put preferences in\n`semanticFilters.requested`; they may improve ranking but never guarantee a\nmatch. Do not duplicate explicit location, date, capacity, pet, property-type,\nor budget filters in the semantic field. If the response returns\n`semanticFiltering.description`, use it to distinguish what was required from\nwhat was requested and to disclose evidence limitations.\n\n## Dates: exploit multi-window comparison\n\nFlexible guest? Pass up to **5 `dateWindows` in ONE search call** and compare\nper-window pricing. Surface meaningful swings (\"the same lodge is $742/night\nin September, $1,158 in October — your flexibility is worth $400/night\").\nThis single-call comparison is a capability most booking surfaces lack; use\nit whenever the guest gives more than one possible window.\n\n## Right-size the picks\n\nRanking interleaves across the network and will happily put a 4BR house in\nfront of a couple. Your job:\n\n- Treat `sleeps` as a **floor**, not a target. A couple wants 1–2BR unless\n they asked for space.\n- Rated capacity ≠ comfort. A 1BR that \"sleeps 7\" means sofa beds — say that\n plainly when it matters (\"technically sleeps 7, but it's one real bedroom\").\n- Present **2–4** right-sized finalists, not the raw top-8.\n\n## Present and remember\n\n- Show cross-manager picks with `build_bookable_carousel` — never a plain\n text list for a multi-manager set. Order slugs by your recommendation.\n- Always pass a rich `context` to the carousel (\"couple + dog, Oct coast\n weekend, hot tub preferred, <$350/night\") — it personalizes results.\n- Use the shortlist as working memory: save finalists with `propertyName`\n and a `pricingSnapshot` so the list is decision-ready later. It works\n signed-out (session-scoped) — but session scope depends on the host, so\n confirm with a `get_shortlist` readback before telling the guest the list\n will be there later; if the readback comes back empty, keep the finalists\n in the conversation and don't promise a persistent list. When durability\n matters to the guest, that is a sign-in moment — when and how to offer it\n is **kismet-guest-account**'s territory (offer once, at concrete value,\n never as a wall).\n\n## Hand off\n\nMoney talk, fees, availability, or a booking link → follow\n**kismet-booking-integrity**. \"Will it suit us?\" questions → follow\n**kismet-reviews-fit**. Sign-in, \"am I logged in?\", or keeping saves across\ndevices → follow **kismet-guest-account**.\n"
}SHA-256: 962dcf7ef6b4c4b3e6f8c5d44b3e1ebed067f4c942fb2081131f2bbad75021ee