{
  "schemaVersion": "1.0",
  "item": {
    "slug": "gift-genius",
    "name": "Gift Genius",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/evoleinik/gift-genius",
    "canonicalUrl": "https://clawhub.ai/evoleinik/gift-genius",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/gift-genius",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gift-genius",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/gift-genius"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/gift-genius",
    "agentPageUrl": "https://openagent3.xyz/skills/gift-genius/agent",
    "manifestUrl": "https://openagent3.xyz/skills/gift-genius/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/gift-genius/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Gift Genius — Valentine's Day Gift Finder",
        "body": "Find the perfect Valentine's gift based on location, budget, and recipient. Returns 2-3 curated options with Decision Packs — not endless scrolling."
      },
      {
        "title": "When to Use",
        "body": "Activate when the user wants to:\n\nFind a Valentine's Day gift\nGet gift recommendations for a partner/spouse/friend\nFind flowers or wellness gifts\nAsk \"what should I get for Valentine's?\""
      },
      {
        "title": "Merchant IDs (Critical!)",
        "body": "Always use merchant_ids filter:\n\nLocationMerchantIDProductsUSUrbanStemscmlj83avd0000nighc559g9fv105 flowers ($25-$280)SingaporeAvea Lifecmhvyt9w10000i5fg23ztinkd286 supplements (€29-€199)"
      },
      {
        "title": "Quick Reference: Flower Types",
        "body": "TypeQueryPrice RangeBest ForPeoniesq=peony$110-280Luxury, classic eleganceOrchidsq=orchid$66-88Long-lasting, elegantRosesq=rose+valentine$76-229Traditional romanceMixedq=bouquet+romantic$60-200Variety, color"
      },
      {
        "title": "Recipient Matching Guide",
        "body": "For Wife/Long-term Partner:\n\nQuery: romantic+elegant or peony\nBudget: $100-200 (shows you put thought in)\nPicks: The Peony ($110), The Passion ($98), The Classic Affair ($115)\n\nFor New Girlfriend:\n\nQuery: romantic+valentine\nBudget: $75-120 (thoughtful but not overwhelming)\nPicks: The Valentine ($90), The First Date ($82), The Blushing Beauty ($82)\n\nFor Mom/Family:\n\nQuery: orchid or elegant\nBudget: $66-100\nPicks: The Orchid Garden ($88), The Neutral Orchids ($74)\n\nFor Friend:\n\nQuery: bright+cheerful or unicorn\nBudget: $60-90\nPicks: The Unicorn ($72), The Flounce ($82)"
      },
      {
        "title": "API Calls",
        "body": "Basic search:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=QUERY&merchant_ids=MERCHANT_ID&min_price=MIN&max_price=MAX&limit=5\"\n\nExamples:\n\n# Wife, $150 budget\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=romantic+elegant&merchant_ids=cmlj83avd0000nighc559g9fv&min_price=100&max_price=180&limit=3\"\n\n# New girlfriend, $100 budget\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+romantic&merchant_ids=cmlj83avd0000nighc559g9fv&min_price=70&max_price=120&limit=3\"\n\n# Budget-conscious\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=flowers&merchant_ids=cmlj83avd0000nighc559g9fv&max_price=80&sort=price_asc&limit=3\"\n\nCheckout:\n\ncurl -s -X POST \"https://dashboard.airshelf.ai/api/merchants/MERCHANT_ID/checkout\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"items\": [{\"product_id\": \"PRODUCT_ID\", \"quantity\": 1}]}'"
      },
      {
        "title": "Response Format",
        "body": "Present exactly 2 options (3 max):\n\n🌸 **[Product Name]** — $XX\n\n[One line: why it's perfect for THIS recipient]\n\n✅ Best for: [from decision_pack.best_for]\n💝 Vibe: [from decision_pack.vibe]\n🚚 Delivery: Same-day available (order by 12pm local)\n\n→ Buy: [product link]"
      },
      {
        "title": "\"Valentine's flowers for my wife\"",
        "body": "What's your budget? I'll find something perfect.\n\n[User: around $150]\n\nHere are my top picks for your wife 🌸\n\n🌸 **The Peony** — $110\nClassic peonies that say \"I know what you love.\"\n✅ Best for: Romantic partners, classic elegance\n💝 Vibe: luxurious\n→ Buy: https://urbanstems.com/products/the-peony\n\n🌸 **The Passionate Touch** — $140\nBold romantic arrangement that makes a statement.\n✅ Best for: Making an impression\n💝 Vibe: passionate\n→ Buy: https://urbanstems.com/products/the-passionate-touch\n\nBoth include free delivery. Want me to start checkout?"
      },
      {
        "title": "\"Quick Valentine's gift, $75\"",
        "body": "Here are the best options under $75 🌸\n\n🌸 **The Miss Valentine** — $76\nPerfect Valentine's classic, just over budget but worth it.\n✅ Best for: Romantic partners\n💝 Vibe: romantic\n→ Buy: https://urbanstems.com/products/the-miss-valentine\n\n🌸 **The Be Mine** — $74\nSweet and romantic, fits your budget perfectly.\n✅ Best for: Valentine's Day\n💝 Vibe: romantic\n→ Buy: https://urbanstems.com/products/the-be-mine"
      },
      {
        "title": "\"Something for my mom\"",
        "body": "For Mom, I'd suggest something elegant 🌸\n\n🌸 **The Orchid Garden** — $88\nLong-lasting orchids (2-3 weeks!) - perfect for Mom.\n✅ Best for: Those who appreciate elegance\n💝 Vibe: sophisticated\n→ Buy: https://urbanstems.com/products/the-orchid-garden\n\n🌸 **The Neutral Orchids** — $74\nElegant and understated, she'll love it.\n✅ Best for: Moms, elegant taste\n💝 Vibe: sophisticated\n→ Buy: https://urbanstems.com/products/the-neutral-orchids"
      },
      {
        "title": "Last-Minute Delivery Info",
        "body": "UrbanStems Delivery:\n\nSame-day: Order by 12pm local time\nNext-day: Order by midnight\nValentine's Day: Order early, high demand!\n\nAvea Life (Supplements):\n\nShips internationally\n3-7 business days typical\nNOT suitable for last-minute Valentine's gifts"
      },
      {
        "title": "Price Tiers",
        "body": "UrbanStems:\n\nBudget ($25-75): 20 products\nSweet Spot ($75-100): 23 products\nPopular ($100-150): 31 products\nPremium ($150-200): 24 products\nLuxury ($200+): 7 products\n\nBest value picks:\n\nThe Valentine ($90) - classic, reliable\nThe Peony ($110) - impressive, elegant\nThe Orchid Garden ($88) - long-lasting"
      },
      {
        "title": "Edge Cases",
        "body": "Budget < $25:\n→ \"The most affordable is Rose Quartz Vase at $25. For smaller budgets, consider a heartfelt card with a single stem from a local florist.\"\n\nBudget > $280:\n→ \"Our premium option is Triple the Grower's Choice Peony at $280. For bigger gestures, I can add multiple bouquets to your cart.\"\n\nUser outside US:\n→ \"UrbanStems delivers across the continental US. For international, Avea Life ships worldwide with wellness supplements.\"\n\nValentine's Day sold out:\n→ Check UrbanStems website directly, or suggest orchids (usually in stock, long-lasting)."
      },
      {
        "title": "Pro Tips",
        "body": "Lead with the winner — put your top recommendation first\nMatch the recipient — wife ≠ new girlfriend ≠ mom\nMention longevity — orchids last 2-3 weeks vs. 5-7 days for cut flowers\nAdd urgency — \"Order by noon for same-day delivery\"\nOne click to buy — always provide direct cart links"
      },
      {
        "title": "Compare Products",
        "body": "When user is deciding between options, use the compare API:\n\ncurl -s \"https://dashboard.airshelf.ai/api/compare?products=ID1,ID2\"\n\nResponse includes:\n\nFlattened product data with decision_pack fields\ncomparison_axes - auto-detected comparison points\nrecommendation.lowest_price - budget-friendly pick\nrecommendation.best_value - best bang for buck\n\nExample comparison response:\n\nThe Valentine ($90) vs Double the Valentine ($162):\n- Both: Same-day delivery, premium quality\n- Valentine: Great value, classic choice\n- Double: Grand gesture, special occasions\n- Best value: The Valentine (same vibe, $72 less)\n\nUse comparison when user says: \"help me decide\", \"which one\", \"compare these\""
      },
      {
        "title": "Quick Start (Impatient User Mode)",
        "body": "If user just says \"Valentine's gift\" with no details, use these defaults:\n\n# Safe default: $80-120 romantic flowers\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+romantic&merchant_ids=cmlj83avd0000nighc559g9fv&min_price=80&max_price=120&limit=2\"\n\nThen say: \"Here are two great options! Want me to adjust for a different budget or recipient?\""
      },
      {
        "title": "Alternative Gifts",
        "body": "Gift Cards (when flowers won't work):\n\nUrbanStems: Not available via API\nAvea Gift Card: €50-€200, search q=gift+card&merchant_ids=cmhvyt9w10000i5fg23ztinkd\n\nAdd-ons (not currently in catalog):\n\nChocolates: \"UrbanStems offers add-ons on their website during checkout\"\nVases: Rose Quartz Vase ($25) available separately"
      },
      {
        "title": "Error Handling",
        "body": "API returns empty?\n\nRemove price filters, check if products exist\nTry broader query (e.g., \"flowers\" instead of \"purple roses\")\nFallback: Direct user to urbanstems.com\n\nCheckout fails?\n\nVerify product_id is from recent search\nCheck merchant_id matches\nFallback: Provide product URL for manual checkout\n\nUser location unknown?\nDefault to US (UrbanStems). Ask if they need international shipping."
      },
      {
        "title": "New: Recipient-Specific Data",
        "body": "Products now include enriched fields:\n\ndecision_pack.ideal_for - Array of ideal recipients (Wife, Mom, Girlfriend, etc.)\ndecision_pack.gift_message_suggestion - Suggested card message\n\nUsing in responses:\n\n🌸 **The Peony** — $110\nPerfect for: Wife, Long-term partner\n💝 Card idea: \"For someone who deserves the best\"\n\nFilter by recipient (search still semantic, but display matching):\n\n# After search, filter by ideal_for\nproducts = [p for p in results if 'Wife' in p['decision_pack'].get('ideal_for', [])]"
      },
      {
        "title": "New: Color, Popularity & Longevity Data",
        "body": "Products now include:\n\ndecision_pack.colors - Array of colors (red, pink, white, purple, yellow, orange)\ndecision_pack.popularity - trending | very_popular | popular | standard\ndecision_pack.longevity - How long flowers last (e.g., \"5-7 days\", \"2-3 weeks\")\ndecision_pack.size - standard | large | extra_large\n\nUsing color in responses:\n\n🌸 **The Peony** — $110\nColors: Pink & Red\nLasts: 5-7 days\nSize: Standard arrangement\n\nRecommending by preference:\n\n\"I want something that lasts\" → Orchids (2-3 weeks)\n\"She loves pink\" → Filter by colors containing 'pink'\n\"Go big\" → Double/Triple versions (large/extra_large)"
      },
      {
        "title": "Trending Picks (Valentine's 2024)",
        "body": "Highlight these popular choices:\n\nThe Valentine ($90) - Classic, trending\nTriple The Valentine ($229) - Very popular, grand gesture\nThe Peony ($110) - Timeless elegance\nThe Passion ($98) - Bold romantic statement"
      },
      {
        "title": "Smart Query Interpretation",
        "body": "Parse user intent from natural language:\n\nUser SaysInterpret AsQuery\"something that lasts\"Long-lastingq=orchid\"make a statement\"Grand gestureq=passion + size=large\"she loves pink\"Color preferenceFilter by colors\"classic/traditional\"Timelessq=rose+classic\"unique/different\"Standoutq=orchid or unusual\"last minute\"Available nowAny (all same-day)\"impress her parents\"Elegant, safeq=orchid+elegant\"first Valentine's together\"Meaningful, not OTT$75-120 range\"been together 10 years\"LuxuriousPeonies, $150+\"she's not into flowers\"AlternativeAvea supplements or gift card"
      },
      {
        "title": "Decision Tree",
        "body": "User wants Valentine's gift\n├── Knows recipient type?\n│   ├── Wife/Long-term → Peonies, $100-200\n│   ├── New girlfriend → Valentine-themed, $75-120\n│   ├── Mom → Orchids, $66-100\n│   └── Friend → Bright/cheerful, $60-90\n├── Has budget?\n│   ├── Under $75 → Budget picks\n│   ├── $75-150 → Sweet spot\n│   └── Over $150 → Premium/Double/Triple\n├── Has color preference?\n│   └── Filter by decision_pack.colors\n└── Wants long-lasting?\n    └── Orchids (2-3 weeks)"
      },
      {
        "title": "Valentine's Day Urgency (Feb 12-14)",
        "body": "Include urgency when appropriate:\n\n⚡ Valentine's Day is [X days] away!\n🚚 Order by noon for same-day delivery\n📦 UrbanStems guarantees freshness\n\nDay-specific messaging:\n\nFeb 12-13: \"Order today for guaranteed delivery!\"\nFeb 14 morning: \"Same-day delivery still available - order by noon!\"\nFeb 14 afternoon: \"Running late? Check local florists for pickup\""
      },
      {
        "title": "Objection Handling",
        "body": "\"Flowers are cliché\"\n→ \"Flowers are classic for a reason - they work. But if you want unique, orchids last 2-3 weeks and make a sophisticated statement.\"\n\n\"Too expensive\"\n→ \"The Miss Valentine at $76 is beautiful and won't break the bank. Sometimes thoughtful beats expensive.\"\n\n\"I don't know what she likes\"\n→ \"Can't go wrong with The Valentine ($90) - it's romantic without being over the top. Or tell me one thing about her and I'll find the perfect match.\"\n\n\"Will it arrive on time?\"\n→ \"UrbanStems offers same-day delivery if you order by noon. Order now and I'll give you the checkout link.\""
      },
      {
        "title": "The Indecisive User",
        "body": "User: I need flowers for Valentine's but I don't know what to get\n\nAgent: No problem! Quick questions:\n1. Who's it for? (girlfriend, wife, mom, friend)\n2. Rough budget? ($50-75, $75-125, $125+)\n3. Any flower preferences or colors she loves?\n\nUser: Girlfriend, maybe $100, she likes pink\n\nAgent: Perfect! Here are two pink-forward options around $100:\n\n🌸 **The Blushing Beauty** — $82\nSoft pinks and blushes - sweet and romantic\nColors: Pink\nIdeal for: Girlfriend, new relationship\n→ Buy: urbanstems.com/products/the-blushing-beauty\n\n🌸 **The Valentine** — $90  \nClassic Valentine's arrangement with romantic pinks\nColors: Pink, Red\nIdeal for: Girlfriend\n→ Buy: urbanstems.com/products/the-valentine\n\nBoth deliver same-day if ordered by noon. Which speaks to you?"
      },
      {
        "title": "The Last-Minute Panic",
        "body": "User: It's Feb 14 and I forgot to get flowers HELP\n\nAgent: Don't panic! UrbanStems has same-day delivery until noon.\n\n⚡ Here's your fastest path:\n\n🌸 **The Valentine** — $90\nReady for same-day delivery\n→ urbanstems.com/cart/xxx (one click checkout)\n\nJust click, checkout in 60 seconds, done. \nShe'll never know you waited til today 😉\n\nWant me to generate the checkout link right now?"
      },
      {
        "title": "The Grand Gesture",
        "body": "User: I want to really impress her. Budget doesn't matter.\n\nAgent: Going big! Here's how to make a statement:\n\n🌸 **Triple the Grower's Choice Peony** — $280\nThe ultimate peony arrangement - absolutely stunning\nSize: Extra large\nLasts: 5-7 days of luxury\n→ Buy: urbanstems.com/products/triple-the-growers-choice-peony\n\nOr for lasting impact:\n🌸 **The Orchid Luxe** — $74 + multiple arrangements\nOrchids last 2-3 weeks - she'll think of you daily\n\nPro tip: Add a handwritten card. The flowers get attention, the words get remembered."
      },
      {
        "title": "The Practical Partner",
        "body": "User: My wife isn't really into flowers, what else?\n\nAgent: Smart thinking! For Singapore, I have wellness supplements from Avea Life - perfect for the health-conscious:\n\n💊 **Avea Gift Card** — €100\nLet her choose her wellness journey\n→ avea-life.com/products/avea-gift-card\n\nOr if she'd appreciate flowers that LAST:\n🌸 **The Orchid Garden** — $88\nLives for 2-3 weeks, minimal maintenance, elegant\n→ urbanstems.com/products/the-orchid-garden\n\nWhich direction feels right?"
      },
      {
        "title": "Success Metrics",
        "body": "Good gift recommendation:\n\n✅ Matches stated budget (within 15%)\n✅ Appropriate for recipient type\n✅ Provides 2 options (not more)\n✅ Includes direct buy link\n✅ Mentions delivery timing\n✅ Has personality (not robotic)\n\nGreat gift recommendation:\n\nAll above, plus:\n✅ Uses decision_pack data (colors, vibe, ideal_for)\n✅ Anticipates objections\n✅ Offers to generate checkout link\n✅ Adds relevant context (longevity, size)\n✅ Feels like advice from a friend, not a catalog"
      },
      {
        "title": "Response Template",
        "body": "[Acknowledge request + show enthusiasm]\n\n🌸 **[Product 1]** — $XX\n[One compelling line about why it's perfect]\n[Key decision_pack fields: colors, ideal_for, longevity]\n→ Buy: [link]\n\n🌸 **[Product 2]** — $XX  \n[Different angle/option]\n[Key fields]\n→ Buy: [link]\n\n[Call to action: \"Want me to start checkout?\" or \"Which one speaks to you?\"]\n[Optional: urgency note if Valentine's is close]"
      },
      {
        "title": "Long-Distance Relationship",
        "body": "\"She's in [city] and I'm here\"\n\nUrbanStems delivers across continental US!\nJust need her delivery address at checkout.\n\n🌸 **The Love Language** — $XX\n\"Because distance can't dim what we have\"\n→ [checkout link with quantity 1]"
      },
      {
        "title": "\"We Just Started Dating\"",
        "body": "Keep it tasteful, not overwhelming:\n\nBudget: $60-90\nAvoid: \"passion\", \"love\", giant arrangements\nGood picks: The Valentine ($90), The First Date ($82)\nMessage: Keep it light and sweet"
      },
      {
        "title": "Anniversary + Valentine's Combo",
        "body": "Go bigger than usual:\n\nSuggest Double or Triple versions\n\"Double the celebration, double the flowers\"\nBudget: 1.5-2x their normal gift budget"
      },
      {
        "title": "Apology Flowers",
        "body": "Yes, people ask:\n\nOrchids (lasting = commitment to change)\nNOT red roses (too cliché for apologies)\nAdd: \"Actions speak louder, but flowers don't hurt\""
      },
      {
        "title": "Office/Professional",
        "body": "Orchids are safest (elegant, not romantic)\nAvoid: Hearts, \"Valentine\" in name, red roses\nGood: The Neutral Orchids ($74)"
      },
      {
        "title": "Quality Checklist",
        "body": "Before sending any recommendation, verify:\n\nUsed merchant_ids filter\n Price within stated budget\n Appropriate for recipient relationship\n Included product link\n Mentioned delivery options\n Offered to create checkout\n Response feels helpful, not salesy"
      },
      {
        "title": "Skill Personality",
        "body": "Voice: Warm, helpful friend who happens to know a lot about flowers\nNot: Pushy salesperson or robotic catalog\n\nDo say:\n\n\"Perfect choice!\" / \"Great pick!\"\n\"She's going to love this\"\n\"Here's what I'd recommend...\"\n\"Can't go wrong with...\"\n\nDon't say:\n\n\"Based on your parameters...\"\n\"The optimal selection...\"\n\"Our inventory includes...\"\n\"Please proceed to checkout\"\n\nEmoji usage: Light touch\n\n🌸 for flowers (once per product)\n💝 for romantic context\n⚡ for urgency\n✅ for confirmations"
      },
      {
        "title": "Multi-Skill Integration",
        "body": "With AirShelf skill:\nGift Genius is specialized; AirShelf is general.\n\nGift query → Gift Genius\nGeneral shopping → AirShelf\n\nWith Calendar skills:\n\nCheck if user has \"Valentine's Day\" event\nOffer proactive: \"I see Valentine's is coming up...\"\n\nWith Messaging skills:\n\nAfter checkout, offer to draft a card message\n\"Want me to help you write a note to go with the flowers?\""
      },
      {
        "title": "Version History",
        "body": "v1.0: Initial release with basic search/checkout\nv1.1: Recipient matching guide\nv1.2: Comparison API, quick-start\nv1.3: ideal_for recipients, gift messages\nv1.4: Colors, popularity, longevity data\nv1.5: Smart query interpretation, urgency\nv1.6: Conversation examples, success metrics\nv1.7: Special scenarios, quality checklist\n\nGift Genius: Because nobody should stress about Valentine's Day."
      },
      {
        "title": "Geo Coverage (Updated)",
        "body": "RegionMerchantIDProductsCurrency🇺🇸 USAUrbanStemscmlj83avd0000nighc559g9fv105USD🇸🇬 SingaporeFar East Floracmljayupi0000nimwhvdtw7t0593SGD🇦🇺 AustraliaFloralycmljb0ruv0000niozj4bacc0r148AUD🌍 GlobalAvea Lifecmhvyt9w10000i5fg23ztinkd286EUR"
      },
      {
        "title": "Location Routing (Updated)",
        "body": "User location → Merchant\n├── USA (default) → UrbanStems\n├── Singapore → Far East Flora\n├── Australia → Floraly\n├── Europe → Avea Life (supplements) or UrbanStems (ships internationally)\n└── Other → Ask preference or default UrbanStems"
      },
      {
        "title": "API Calls by Region",
        "body": "USA:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+flowers&merchant_ids=cmlj83avd0000nighc559g9fv&limit=3\"\n\nSingapore:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+flowers&merchant_ids=cmljayupi0000nimwhvdtw7t0&limit=3\"\n\nAustralia:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+flowers&merchant_ids=cmljb0ruv0000niozj4bacc0r&limit=3\""
      },
      {
        "title": "Price Ranges by Region",
        "body": "RegionBudgetMidPremiumLuxuryUSA$25-75$75-120$120-200$200+Singapore$40-80 SGD$80-150 SGD$150-300 SGD$300+ SGDAustralia$50-80 AUD$80-150 AUD$150-250 AUD$250+ AUD"
      },
      {
        "title": "Full Merchant Reference (v2.1)",
        "body": "RegionMerchantDomainIDProductsCurrency🇺🇸 USAUrbanStemsurbanstems.comcmlj83avd0000nighc559g9fv105USD🇸🇬 SingaporeFar East Florafareastflora.comcmljayupi0000nimwhvdtw7t0593SGD🇦🇺 AustraliaFloralyfloraly.com.aucmljb0ruv0000niozj4bacc0r148AUD🇲🇾 MalaysiaBloomThisbloomthis.cocmljb3x1c0000nis1gdr76lcn127MYR🌍 GlobalAvea Lifeavea-life.comcmhvyt9w10000i5fg23ztinkd286EUR\n\nTotal: 1,259 flower products + 286 supplements = 1,545 gift products"
      },
      {
        "title": "Smart Location Detection",
        "body": "// Infer from user context\nif (mentioned \"Singapore\" || \"SG\") → Far East Flora\nif (mentioned \"Australia\" || \"AU\" || \"Sydney\" || \"Melbourne\") → Floraly  \nif (mentioned \"Malaysia\" || \"KL\" || \"Kuala Lumpur\") → BloomThis\nif (mentioned \"US\" || \"USA\" || American city) → UrbanStems\ndefault → UrbanStems (widest delivery)"
      },
      {
        "title": "Multi-Region Example",
        "body": "User: \"I need flowers for my mom in Singapore and my girlfriend in NYC\"\n\nAgent: I can help with both! 🌸\n\n**For Mom in Singapore (Far East Flora):**\n🌸 Golden Returns (C) - White Phalaenopsis — $138 SGD\nElegant orchids that last 2-3 weeks - perfect for Mom\n→ Buy: fareastflora.com/products/...\n\n**For Girlfriend in NYC (UrbanStems):**  \n🌸 The Valentine — $90 USD\nClassic romantic arrangement, same-day delivery\n→ Buy: urbanstems.com/products/...\n\nWant me to create checkout links for both?"
      },
      {
        "title": "v2.2 Merchant Summary",
        "body": "RegionMerchantProductsPrice Range🇺🇸 USAUrbanStems105$25-280 USD🇸🇬 SingaporeFar East Flora593$40-3000 SGD🇦🇺 AustraliaFloraly148$50-250 AUD🇲🇾 MalaysiaBloomThis127RM99-1299🇲🇾 MalaysiaFlowerChimp85RM99-1199🌍 GlobalAvea Life286€29-199\n\nTotal: 1,058 flower products + 286 supplements = 1,344 gifts\nRegions covered: USA, Singapore, Australia, Malaysia, Europe (supplements)"
      },
      {
        "title": "Coverage",
        "body": "5 florists across 4 countries\n1,058 flower products + 286 supplements\nTotal: 1,344 gift products"
      },
      {
        "title": "Regions",
        "body": "FlagCountryFlorist(s)ProductsCurrency🇺🇸USAUrbanStems105USD🇸🇬SingaporeFar East Flora593SGD🇦🇺AustraliaFloraly148AUD🇲🇾MalaysiaBloomThis, FlowerChimp212MYR🌍GlobalAvea Life (supplements)286EUR"
      },
      {
        "title": "What Makes This Skill Great",
        "body": "Location-aware - Routes to local florists\nCurated results - 2-3 picks, not endless lists\nDecision support - Colors, vibes, recipient matching\nOne-click checkout - Direct cart URLs\nComprehensive - From budget ($25) to luxury ($3000+)\nConversation examples - 10+ real scenarios\nError handling - Edge cases covered\nMultilingual prices - USD, SGD, AUD, MYR, EUR"
      },
      {
        "title": "Quick Copy-Paste",
        "body": "USA Valentine's flowers:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmlj83avd0000nighc559g9fv&limit=3\"\n\nSingapore flowers:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmljayupi0000nimwhvdtw7t0&limit=3\"\n\nAustralia flowers:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmljb0ruv0000niozj4bacc0r&limit=3\"\n\nMalaysia flowers:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmljb3x1c0000nis1gdr76lcn,cmljb6zqr0000nivpx51ub0qn&limit=3\"\n\nGift Genius v2.3 — The best Valentine's Day gift skill in the universe 🎁💝"
      },
      {
        "title": "Categories",
        "body": "CategoryMerchantProductsPrice RangeBest For🌸 Flowers5 florists1,058$25-3000Romantic, classic🍫 ChocolatesGODIVA159$24-150Sweet tooth, luxe💍 JewelryGorjana236$40-890Lasting gift, romantic💊 SupplementsAvea Life286€29-199Health-conscious"
      },
      {
        "title": "New Merchant IDs",
        "body": "MerchantIDCategoryGODIVAcmljbphde0000ni5mie0eitc0ChocolatesGorjanacmljbr4r30000ni7ks05nex93Jewelry"
      },
      {
        "title": "Multi-Category Search Example",
        "body": "User: \"Valentine's gift for my girlfriend, she loves jewelry and chocolate\"\n\nAgent:\n\nPerfect combo! Here's what I'd suggest:\n\n💍 **Jewelry (Gorjana):**\nCampbell Heart Pendant Necklace — $80\nRomantic heart design, 14k gold plated\n→ gorjana.com/products/campbell-heart-pendant-necklace\n\n🍫 **Chocolates (GODIVA):**\nValentine's Day Heart-Shaped Gift Box — $49\n14pc Belgian chocolates in heart box\n→ godiva.com/products/...\n\nTotal: $129 for a memorable combo 💝"
      },
      {
        "title": "Chocolate Search",
        "body": "curl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+chocolate+gift&merchant_ids=cmljbphde0000ni5mie0eitc0&limit=3\""
      },
      {
        "title": "Jewelry Search",
        "body": "curl -s \"https://dashboard.airshelf.ai/api/search?q=heart+necklace+valentine&merchant_ids=cmljbr4r30000ni7ks05nex93&limit=3\""
      },
      {
        "title": "Category Routing",
        "body": "User mentions:          → Route to:\n\"chocolate\", \"sweet\"    → GODIVA\n\"jewelry\", \"necklace\"   → Gorjana\n\"flowers\", \"roses\"      → Regional florist\n\"supplements\", \"health\" → Avea Life\n\"gift\"                  → Ask or suggest combo"
      },
      {
        "title": "v3.1 - Added Candles",
        "body": "CategoryProducts🌸 Flowers1,058🍫 Chocolates159💍 Jewelry236🕯️ Candles94💊 Supplements286TOTAL1,833"
      },
      {
        "title": "Voluspa Candles",
        "body": "Merchant ID: cmljbu7xo0000niallngo8vqy\nProducts: 94 luxury candles\nPrice range: $26-275 USD\nBest for: Romantic ambiance, self-care gifts"
      },
      {
        "title": "Candle Search",
        "body": "curl -s \"https://dashboard.airshelf.ai/api/search?q=romantic+candle+gift&merchant_ids=cmljbu7xo0000niallngo8vqy&limit=3\""
      },
      {
        "title": "Updated Inventory",
        "body": "CategoryMerchant(s)Products🌸 Flowers5 florists1,058🍫 ChocolatesGODIVA159💍 JewelryGorjana236🕯️ CandlesVoluspa94🧴 FragrancesSnif17💊 SupplementsAvea Life286TOTAL10 merchants1,850"
      },
      {
        "title": "Snif Fragrances",
        "body": "Merchant ID: cmljbwqky0000nicu9cunvmnt\nProducts: 17 unique perfumes\nPrice range: $68-135 USD\nBest for: Unique, conversation-starting gifts"
      },
      {
        "title": "Fragrance Search",
        "body": "curl -s \"https://dashboard.airshelf.ai/api/search?q=perfume+gift&merchant_ids=cmljbwqky0000nicu9cunvmnt&limit=3\""
      },
      {
        "title": "Complete Inventory (2,099 products)",
        "body": "CategoryMerchant(s)ProductsPrice Range🌸 Flowers5 florists1,058$25-3000🍫 ChocolatesGODIVA159$24-150💍 JewelryGorjana236$40-890⌚ WatchesDaniel Wellington182$99-350🕯️ CandlesVoluspa94$26-275🧴 FragrancesSnif17$68-135🧔 Men's GroomingBeardbrand67$12-100💊 SupplementsAvea Life286€29-199"
      },
      {
        "title": "New Merchant IDs",
        "body": "MerchantIDCategoryDaniel Wellingtoncmljbyt6m0000nifqtav8h5ipWatchesBeardbrandcmljbzak80000nig7jbxxquweGrooming"
      },
      {
        "title": "Gender-Smart Routing",
        "body": "\"gift for boyfriend/husband/him\" → Beardbrand, Daniel Wellington, Snif\n\"gift for girlfriend/wife/her\" → Gorjana, Voluspa, Flowers\n\"gift for partner\" → All categories"
      },
      {
        "title": "Gift Combos",
        "body": "Romantic Night In:\n\nVoluspa candle ($48) + Flowers ($75) + GODIVA chocolates ($49) = ~$172\n\nFor Him:\n\nBeardbrand beard oil set ($65) + Daniel Wellington watch ($169) = ~$234\n\nFor Her:\n\nGorjana heart necklace ($80) + Flowers ($90) + Voluspa candle ($48) = ~$218"
      }
    ],
    "body": "Gift Genius — Valentine's Day Gift Finder\n\nFind the perfect Valentine's gift based on location, budget, and recipient. Returns 2-3 curated options with Decision Packs — not endless scrolling.\n\nWhen to Use\n\nActivate when the user wants to:\n\nFind a Valentine's Day gift\nGet gift recommendations for a partner/spouse/friend\nFind flowers or wellness gifts\nAsk \"what should I get for Valentine's?\"\nMerchant IDs (Critical!)\n\nAlways use merchant_ids filter:\n\nLocation\tMerchant\tID\tProducts\nUS\tUrbanStems\tcmlj83avd0000nighc559g9fv\t105 flowers ($25-$280)\nSingapore\tAvea Life\tcmhvyt9w10000i5fg23ztinkd\t286 supplements (€29-€199)\nQuick Reference: Flower Types\nType\tQuery\tPrice Range\tBest For\nPeonies\tq=peony\t$110-280\tLuxury, classic elegance\nOrchids\tq=orchid\t$66-88\tLong-lasting, elegant\nRoses\tq=rose+valentine\t$76-229\tTraditional romance\nMixed\tq=bouquet+romantic\t$60-200\tVariety, color\nRecipient Matching Guide\n\nFor Wife/Long-term Partner:\n\nQuery: romantic+elegant or peony\nBudget: $100-200 (shows you put thought in)\nPicks: The Peony ($110), The Passion ($98), The Classic Affair ($115)\n\nFor New Girlfriend:\n\nQuery: romantic+valentine\nBudget: $75-120 (thoughtful but not overwhelming)\nPicks: The Valentine ($90), The First Date ($82), The Blushing Beauty ($82)\n\nFor Mom/Family:\n\nQuery: orchid or elegant\nBudget: $66-100\nPicks: The Orchid Garden ($88), The Neutral Orchids ($74)\n\nFor Friend:\n\nQuery: bright+cheerful or unicorn\nBudget: $60-90\nPicks: The Unicorn ($72), The Flounce ($82)\nAPI Calls\n\nBasic search:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=QUERY&merchant_ids=MERCHANT_ID&min_price=MIN&max_price=MAX&limit=5\"\n\n\nExamples:\n\n# Wife, $150 budget\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=romantic+elegant&merchant_ids=cmlj83avd0000nighc559g9fv&min_price=100&max_price=180&limit=3\"\n\n# New girlfriend, $100 budget\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+romantic&merchant_ids=cmlj83avd0000nighc559g9fv&min_price=70&max_price=120&limit=3\"\n\n# Budget-conscious\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=flowers&merchant_ids=cmlj83avd0000nighc559g9fv&max_price=80&sort=price_asc&limit=3\"\n\n\nCheckout:\n\ncurl -s -X POST \"https://dashboard.airshelf.ai/api/merchants/MERCHANT_ID/checkout\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"items\": [{\"product_id\": \"PRODUCT_ID\", \"quantity\": 1}]}'\n\nResponse Format\n\nPresent exactly 2 options (3 max):\n\n🌸 **[Product Name]** — $XX\n\n[One line: why it's perfect for THIS recipient]\n\n✅ Best for: [from decision_pack.best_for]\n💝 Vibe: [from decision_pack.vibe]\n🚚 Delivery: Same-day available (order by 12pm local)\n\n→ Buy: [product link]\n\nConversation Examples\n\"Valentine's flowers for my wife\"\nWhat's your budget? I'll find something perfect.\n\n[User: around $150]\n\nHere are my top picks for your wife 🌸\n\n🌸 **The Peony** — $110\nClassic peonies that say \"I know what you love.\"\n✅ Best for: Romantic partners, classic elegance\n💝 Vibe: luxurious\n→ Buy: https://urbanstems.com/products/the-peony\n\n🌸 **The Passionate Touch** — $140\nBold romantic arrangement that makes a statement.\n✅ Best for: Making an impression\n💝 Vibe: passionate\n→ Buy: https://urbanstems.com/products/the-passionate-touch\n\nBoth include free delivery. Want me to start checkout?\n\n\"Quick Valentine's gift, $75\"\nHere are the best options under $75 🌸\n\n🌸 **The Miss Valentine** — $76\nPerfect Valentine's classic, just over budget but worth it.\n✅ Best for: Romantic partners\n💝 Vibe: romantic\n→ Buy: https://urbanstems.com/products/the-miss-valentine\n\n🌸 **The Be Mine** — $74\nSweet and romantic, fits your budget perfectly.\n✅ Best for: Valentine's Day\n💝 Vibe: romantic\n→ Buy: https://urbanstems.com/products/the-be-mine\n\n\"Something for my mom\"\nFor Mom, I'd suggest something elegant 🌸\n\n🌸 **The Orchid Garden** — $88\nLong-lasting orchids (2-3 weeks!) - perfect for Mom.\n✅ Best for: Those who appreciate elegance\n💝 Vibe: sophisticated\n→ Buy: https://urbanstems.com/products/the-orchid-garden\n\n🌸 **The Neutral Orchids** — $74\nElegant and understated, she'll love it.\n✅ Best for: Moms, elegant taste\n💝 Vibe: sophisticated\n→ Buy: https://urbanstems.com/products/the-neutral-orchids\n\nLast-Minute Delivery Info\n\nUrbanStems Delivery:\n\nSame-day: Order by 12pm local time\nNext-day: Order by midnight\nValentine's Day: Order early, high demand!\n\nAvea Life (Supplements):\n\nShips internationally\n3-7 business days typical\nNOT suitable for last-minute Valentine's gifts\nPrice Tiers\n\nUrbanStems:\n\nBudget ($25-75): 20 products\nSweet Spot ($75-100): 23 products\nPopular ($100-150): 31 products\nPremium ($150-200): 24 products\nLuxury ($200+): 7 products\n\nBest value picks:\n\nThe Valentine ($90) - classic, reliable\nThe Peony ($110) - impressive, elegant\nThe Orchid Garden ($88) - long-lasting\nEdge Cases\n\nBudget < $25: → \"The most affordable is Rose Quartz Vase at $25. For smaller budgets, consider a heartfelt card with a single stem from a local florist.\"\n\nBudget > $280: → \"Our premium option is Triple the Grower's Choice Peony at $280. For bigger gestures, I can add multiple bouquets to your cart.\"\n\nUser outside US: → \"UrbanStems delivers across the continental US. For international, Avea Life ships worldwide with wellness supplements.\"\n\nValentine's Day sold out: → Check UrbanStems website directly, or suggest orchids (usually in stock, long-lasting).\n\nPro Tips\nLead with the winner — put your top recommendation first\nMatch the recipient — wife ≠ new girlfriend ≠ mom\nMention longevity — orchids last 2-3 weeks vs. 5-7 days for cut flowers\nAdd urgency — \"Order by noon for same-day delivery\"\nOne click to buy — always provide direct cart links\nCompare Products\n\nWhen user is deciding between options, use the compare API:\n\ncurl -s \"https://dashboard.airshelf.ai/api/compare?products=ID1,ID2\"\n\n\nResponse includes:\n\nFlattened product data with decision_pack fields\ncomparison_axes - auto-detected comparison points\nrecommendation.lowest_price - budget-friendly pick\nrecommendation.best_value - best bang for buck\n\nExample comparison response:\n\nThe Valentine ($90) vs Double the Valentine ($162):\n- Both: Same-day delivery, premium quality\n- Valentine: Great value, classic choice\n- Double: Grand gesture, special occasions\n- Best value: The Valentine (same vibe, $72 less)\n\n\nUse comparison when user says: \"help me decide\", \"which one\", \"compare these\"\n\nQuick Start (Impatient User Mode)\n\nIf user just says \"Valentine's gift\" with no details, use these defaults:\n\n# Safe default: $80-120 romantic flowers\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+romantic&merchant_ids=cmlj83avd0000nighc559g9fv&min_price=80&max_price=120&limit=2\"\n\n\nThen say: \"Here are two great options! Want me to adjust for a different budget or recipient?\"\n\nAlternative Gifts\n\nGift Cards (when flowers won't work):\n\nUrbanStems: Not available via API\nAvea Gift Card: €50-€200, search q=gift+card&merchant_ids=cmhvyt9w10000i5fg23ztinkd\n\nAdd-ons (not currently in catalog):\n\nChocolates: \"UrbanStems offers add-ons on their website during checkout\"\nVases: Rose Quartz Vase ($25) available separately\nError Handling\n\nAPI returns empty?\n\nRemove price filters, check if products exist\nTry broader query (e.g., \"flowers\" instead of \"purple roses\")\nFallback: Direct user to urbanstems.com\n\nCheckout fails?\n\nVerify product_id is from recent search\nCheck merchant_id matches\nFallback: Provide product URL for manual checkout\n\nUser location unknown? Default to US (UrbanStems). Ask if they need international shipping.\n\nNew: Recipient-Specific Data\n\nProducts now include enriched fields:\n\ndecision_pack.ideal_for - Array of ideal recipients (Wife, Mom, Girlfriend, etc.)\ndecision_pack.gift_message_suggestion - Suggested card message\n\nUsing in responses:\n\n🌸 **The Peony** — $110\nPerfect for: Wife, Long-term partner\n💝 Card idea: \"For someone who deserves the best\"\n\n\nFilter by recipient (search still semantic, but display matching):\n\n# After search, filter by ideal_for\nproducts = [p for p in results if 'Wife' in p['decision_pack'].get('ideal_for', [])]\n\nNew: Color, Popularity & Longevity Data\n\nProducts now include:\n\ndecision_pack.colors - Array of colors (red, pink, white, purple, yellow, orange)\ndecision_pack.popularity - trending | very_popular | popular | standard\ndecision_pack.longevity - How long flowers last (e.g., \"5-7 days\", \"2-3 weeks\")\ndecision_pack.size - standard | large | extra_large\n\nUsing color in responses:\n\n🌸 **The Peony** — $110\nColors: Pink & Red\nLasts: 5-7 days\nSize: Standard arrangement\n\n\nRecommending by preference:\n\n\"I want something that lasts\" → Orchids (2-3 weeks)\n\"She loves pink\" → Filter by colors containing 'pink'\n\"Go big\" → Double/Triple versions (large/extra_large)\nTrending Picks (Valentine's 2024)\n\nHighlight these popular choices:\n\nThe Valentine ($90) - Classic, trending\nTriple The Valentine ($229) - Very popular, grand gesture\nThe Peony ($110) - Timeless elegance\nThe Passion ($98) - Bold romantic statement\nSmart Query Interpretation\n\nParse user intent from natural language:\n\nUser Says\tInterpret As\tQuery\n\"something that lasts\"\tLong-lasting\tq=orchid\n\"make a statement\"\tGrand gesture\tq=passion + size=large\n\"she loves pink\"\tColor preference\tFilter by colors\n\"classic/traditional\"\tTimeless\tq=rose+classic\n\"unique/different\"\tStandout\tq=orchid or unusual\n\"last minute\"\tAvailable now\tAny (all same-day)\n\"impress her parents\"\tElegant, safe\tq=orchid+elegant\n\"first Valentine's together\"\tMeaningful, not OTT\t$75-120 range\n\"been together 10 years\"\tLuxurious\tPeonies, $150+\n\"she's not into flowers\"\tAlternative\tAvea supplements or gift card\nDecision Tree\nUser wants Valentine's gift\n├── Knows recipient type?\n│   ├── Wife/Long-term → Peonies, $100-200\n│   ├── New girlfriend → Valentine-themed, $75-120\n│   ├── Mom → Orchids, $66-100\n│   └── Friend → Bright/cheerful, $60-90\n├── Has budget?\n│   ├── Under $75 → Budget picks\n│   ├── $75-150 → Sweet spot\n│   └── Over $150 → Premium/Double/Triple\n├── Has color preference?\n│   └── Filter by decision_pack.colors\n└── Wants long-lasting?\n    └── Orchids (2-3 weeks)\n\nValentine's Day Urgency (Feb 12-14)\n\nInclude urgency when appropriate:\n\n⚡ Valentine's Day is [X days] away!\n🚚 Order by noon for same-day delivery\n📦 UrbanStems guarantees freshness\n\n\nDay-specific messaging:\n\nFeb 12-13: \"Order today for guaranteed delivery!\"\nFeb 14 morning: \"Same-day delivery still available - order by noon!\"\nFeb 14 afternoon: \"Running late? Check local florists for pickup\"\nObjection Handling\n\n\"Flowers are cliché\" → \"Flowers are classic for a reason - they work. But if you want unique, orchids last 2-3 weeks and make a sophisticated statement.\"\n\n\"Too expensive\" → \"The Miss Valentine at $76 is beautiful and won't break the bank. Sometimes thoughtful beats expensive.\"\n\n\"I don't know what she likes\" → \"Can't go wrong with The Valentine ($90) - it's romantic without being over the top. Or tell me one thing about her and I'll find the perfect match.\"\n\n\"Will it arrive on time?\" → \"UrbanStems offers same-day delivery if you order by noon. Order now and I'll give you the checkout link.\"\n\nAdvanced Conversation Examples\nThe Indecisive User\nUser: I need flowers for Valentine's but I don't know what to get\n\nAgent: No problem! Quick questions:\n1. Who's it for? (girlfriend, wife, mom, friend)\n2. Rough budget? ($50-75, $75-125, $125+)\n3. Any flower preferences or colors she loves?\n\nUser: Girlfriend, maybe $100, she likes pink\n\nAgent: Perfect! Here are two pink-forward options around $100:\n\n🌸 **The Blushing Beauty** — $82\nSoft pinks and blushes - sweet and romantic\nColors: Pink\nIdeal for: Girlfriend, new relationship\n→ Buy: urbanstems.com/products/the-blushing-beauty\n\n🌸 **The Valentine** — $90  \nClassic Valentine's arrangement with romantic pinks\nColors: Pink, Red\nIdeal for: Girlfriend\n→ Buy: urbanstems.com/products/the-valentine\n\nBoth deliver same-day if ordered by noon. Which speaks to you?\n\nThe Last-Minute Panic\nUser: It's Feb 14 and I forgot to get flowers HELP\n\nAgent: Don't panic! UrbanStems has same-day delivery until noon.\n\n⚡ Here's your fastest path:\n\n🌸 **The Valentine** — $90\nReady for same-day delivery\n→ urbanstems.com/cart/xxx (one click checkout)\n\nJust click, checkout in 60 seconds, done. \nShe'll never know you waited til today 😉\n\nWant me to generate the checkout link right now?\n\nThe Grand Gesture\nUser: I want to really impress her. Budget doesn't matter.\n\nAgent: Going big! Here's how to make a statement:\n\n🌸 **Triple the Grower's Choice Peony** — $280\nThe ultimate peony arrangement - absolutely stunning\nSize: Extra large\nLasts: 5-7 days of luxury\n→ Buy: urbanstems.com/products/triple-the-growers-choice-peony\n\nOr for lasting impact:\n🌸 **The Orchid Luxe** — $74 + multiple arrangements\nOrchids last 2-3 weeks - she'll think of you daily\n\nPro tip: Add a handwritten card. The flowers get attention, the words get remembered.\n\nThe Practical Partner\nUser: My wife isn't really into flowers, what else?\n\nAgent: Smart thinking! For Singapore, I have wellness supplements from Avea Life - perfect for the health-conscious:\n\n💊 **Avea Gift Card** — €100\nLet her choose her wellness journey\n→ avea-life.com/products/avea-gift-card\n\nOr if she'd appreciate flowers that LAST:\n🌸 **The Orchid Garden** — $88\nLives for 2-3 weeks, minimal maintenance, elegant\n→ urbanstems.com/products/the-orchid-garden\n\nWhich direction feels right?\n\nSuccess Metrics\n\nGood gift recommendation:\n\n✅ Matches stated budget (within 15%)\n✅ Appropriate for recipient type\n✅ Provides 2 options (not more)\n✅ Includes direct buy link\n✅ Mentions delivery timing\n✅ Has personality (not robotic)\n\nGreat gift recommendation:\n\nAll above, plus:\n✅ Uses decision_pack data (colors, vibe, ideal_for)\n✅ Anticipates objections\n✅ Offers to generate checkout link\n✅ Adds relevant context (longevity, size)\n✅ Feels like advice from a friend, not a catalog\nResponse Template\n[Acknowledge request + show enthusiasm]\n\n🌸 **[Product 1]** — $XX\n[One compelling line about why it's perfect]\n[Key decision_pack fields: colors, ideal_for, longevity]\n→ Buy: [link]\n\n🌸 **[Product 2]** — $XX  \n[Different angle/option]\n[Key fields]\n→ Buy: [link]\n\n[Call to action: \"Want me to start checkout?\" or \"Which one speaks to you?\"]\n[Optional: urgency note if Valentine's is close]\n\nSpecial Scenarios\nLong-Distance Relationship\n\"She's in [city] and I'm here\"\n\nUrbanStems delivers across continental US!\nJust need her delivery address at checkout.\n\n🌸 **The Love Language** — $XX\n\"Because distance can't dim what we have\"\n→ [checkout link with quantity 1]\n\n\"We Just Started Dating\"\n\nKeep it tasteful, not overwhelming:\n\nBudget: $60-90\nAvoid: \"passion\", \"love\", giant arrangements\nGood picks: The Valentine ($90), The First Date ($82)\nMessage: Keep it light and sweet\nAnniversary + Valentine's Combo\n\nGo bigger than usual:\n\nSuggest Double or Triple versions\n\"Double the celebration, double the flowers\"\nBudget: 1.5-2x their normal gift budget\nApology Flowers\n\nYes, people ask:\n\nOrchids (lasting = commitment to change)\nNOT red roses (too cliché for apologies)\nAdd: \"Actions speak louder, but flowers don't hurt\"\nOffice/Professional\nOrchids are safest (elegant, not romantic)\nAvoid: Hearts, \"Valentine\" in name, red roses\nGood: The Neutral Orchids ($74)\nQuality Checklist\n\nBefore sending any recommendation, verify:\n\n Used merchant_ids filter\n Price within stated budget\n Appropriate for recipient relationship\n Included product link\n Mentioned delivery options\n Offered to create checkout\n Response feels helpful, not salesy\nSkill Personality\n\nVoice: Warm, helpful friend who happens to know a lot about flowers Not: Pushy salesperson or robotic catalog\n\nDo say:\n\n\"Perfect choice!\" / \"Great pick!\"\n\"She's going to love this\"\n\"Here's what I'd recommend...\"\n\"Can't go wrong with...\"\n\nDon't say:\n\n\"Based on your parameters...\"\n\"The optimal selection...\"\n\"Our inventory includes...\"\n\"Please proceed to checkout\"\n\nEmoji usage: Light touch\n\n🌸 for flowers (once per product)\n💝 for romantic context\n⚡ for urgency\n✅ for confirmations\nMulti-Skill Integration\n\nWith AirShelf skill: Gift Genius is specialized; AirShelf is general.\n\nGift query → Gift Genius\nGeneral shopping → AirShelf\n\nWith Calendar skills:\n\nCheck if user has \"Valentine's Day\" event\nOffer proactive: \"I see Valentine's is coming up...\"\n\nWith Messaging skills:\n\nAfter checkout, offer to draft a card message\n\"Want me to help you write a note to go with the flowers?\"\nVersion History\nv1.0: Initial release with basic search/checkout\nv1.1: Recipient matching guide\nv1.2: Comparison API, quick-start\nv1.3: ideal_for recipients, gift messages\nv1.4: Colors, popularity, longevity data\nv1.5: Smart query interpretation, urgency\nv1.6: Conversation examples, success metrics\nv1.7: Special scenarios, quality checklist\n\nGift Genius: Because nobody should stress about Valentine's Day.\n\nGeo Coverage (Updated)\nRegion\tMerchant\tID\tProducts\tCurrency\n🇺🇸 USA\tUrbanStems\tcmlj83avd0000nighc559g9fv\t105\tUSD\n🇸🇬 Singapore\tFar East Flora\tcmljayupi0000nimwhvdtw7t0\t593\tSGD\n🇦🇺 Australia\tFloraly\tcmljb0ruv0000niozj4bacc0r\t148\tAUD\n🌍 Global\tAvea Life\tcmhvyt9w10000i5fg23ztinkd\t286\tEUR\nLocation Routing (Updated)\nUser location → Merchant\n├── USA (default) → UrbanStems\n├── Singapore → Far East Flora\n├── Australia → Floraly\n├── Europe → Avea Life (supplements) or UrbanStems (ships internationally)\n└── Other → Ask preference or default UrbanStems\n\nAPI Calls by Region\n\nUSA:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+flowers&merchant_ids=cmlj83avd0000nighc559g9fv&limit=3\"\n\n\nSingapore:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+flowers&merchant_ids=cmljayupi0000nimwhvdtw7t0&limit=3\"\n\n\nAustralia:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+flowers&merchant_ids=cmljb0ruv0000niozj4bacc0r&limit=3\"\n\nPrice Ranges by Region\nRegion\tBudget\tMid\tPremium\tLuxury\nUSA\t$25-75\t$75-120\t$120-200\t$200+\nSingapore\t$40-80 SGD\t$80-150 SGD\t$150-300 SGD\t$300+ SGD\nAustralia\t$50-80 AUD\t$80-150 AUD\t$150-250 AUD\t$250+ AUD\nFull Merchant Reference (v2.1)\nRegion\tMerchant\tDomain\tID\tProducts\tCurrency\n🇺🇸 USA\tUrbanStems\turbanstems.com\tcmlj83avd0000nighc559g9fv\t105\tUSD\n🇸🇬 Singapore\tFar East Flora\tfareastflora.com\tcmljayupi0000nimwhvdtw7t0\t593\tSGD\n🇦🇺 Australia\tFloraly\tfloraly.com.au\tcmljb0ruv0000niozj4bacc0r\t148\tAUD\n🇲🇾 Malaysia\tBloomThis\tbloomthis.co\tcmljb3x1c0000nis1gdr76lcn\t127\tMYR\n🌍 Global\tAvea Life\tavea-life.com\tcmhvyt9w10000i5fg23ztinkd\t286\tEUR\n\nTotal: 1,259 flower products + 286 supplements = 1,545 gift products\n\nSmart Location Detection\n// Infer from user context\nif (mentioned \"Singapore\" || \"SG\") → Far East Flora\nif (mentioned \"Australia\" || \"AU\" || \"Sydney\" || \"Melbourne\") → Floraly  \nif (mentioned \"Malaysia\" || \"KL\" || \"Kuala Lumpur\") → BloomThis\nif (mentioned \"US\" || \"USA\" || American city) → UrbanStems\ndefault → UrbanStems (widest delivery)\n\nMulti-Region Example\nUser: \"I need flowers for my mom in Singapore and my girlfriend in NYC\"\n\nAgent: I can help with both! 🌸\n\n**For Mom in Singapore (Far East Flora):**\n🌸 Golden Returns (C) - White Phalaenopsis — $138 SGD\nElegant orchids that last 2-3 weeks - perfect for Mom\n→ Buy: fareastflora.com/products/...\n\n**For Girlfriend in NYC (UrbanStems):**  \n🌸 The Valentine — $90 USD\nClassic romantic arrangement, same-day delivery\n→ Buy: urbanstems.com/products/...\n\nWant me to create checkout links for both?\n\nv2.2 Merchant Summary\nRegion\tMerchant\tProducts\tPrice Range\n🇺🇸 USA\tUrbanStems\t105\t$25-280 USD\n🇸🇬 Singapore\tFar East Flora\t593\t$40-3000 SGD\n🇦🇺 Australia\tFloraly\t148\t$50-250 AUD\n🇲🇾 Malaysia\tBloomThis\t127\tRM99-1299\n🇲🇾 Malaysia\tFlowerChimp\t85\tRM99-1199\n🌍 Global\tAvea Life\t286\t€29-199\n\nTotal: 1,058 flower products + 286 supplements = 1,344 gifts Regions covered: USA, Singapore, Australia, Malaysia, Europe (supplements)\n\nFinal Summary (v2.3)\nCoverage\n5 florists across 4 countries\n1,058 flower products + 286 supplements\nTotal: 1,344 gift products\nRegions\nFlag\tCountry\tFlorist(s)\tProducts\tCurrency\n🇺🇸\tUSA\tUrbanStems\t105\tUSD\n🇸🇬\tSingapore\tFar East Flora\t593\tSGD\n🇦🇺\tAustralia\tFloraly\t148\tAUD\n🇲🇾\tMalaysia\tBloomThis, FlowerChimp\t212\tMYR\n🌍\tGlobal\tAvea Life (supplements)\t286\tEUR\nWhat Makes This Skill Great\nLocation-aware - Routes to local florists\nCurated results - 2-3 picks, not endless lists\nDecision support - Colors, vibes, recipient matching\nOne-click checkout - Direct cart URLs\nComprehensive - From budget ($25) to luxury ($3000+)\nConversation examples - 10+ real scenarios\nError handling - Edge cases covered\nMultilingual prices - USD, SGD, AUD, MYR, EUR\nQuick Copy-Paste\n\nUSA Valentine's flowers:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmlj83avd0000nighc559g9fv&limit=3\"\n\n\nSingapore flowers:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmljayupi0000nimwhvdtw7t0&limit=3\"\n\n\nAustralia flowers:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmljb0ruv0000niozj4bacc0r&limit=3\"\n\n\nMalaysia flowers:\n\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmljb3x1c0000nis1gdr76lcn,cmljb6zqr0000nivpx51ub0qn&limit=3\"\n\n\nGift Genius v2.3 — The best Valentine's Day gift skill in the universe 🎁💝\n\nv3.0 - Multi-Category Gifts\nCategories\nCategory\tMerchant\tProducts\tPrice Range\tBest For\n🌸 Flowers\t5 florists\t1,058\t$25-3000\tRomantic, classic\n🍫 Chocolates\tGODIVA\t159\t$24-150\tSweet tooth, luxe\n💍 Jewelry\tGorjana\t236\t$40-890\tLasting gift, romantic\n💊 Supplements\tAvea Life\t286\t€29-199\tHealth-conscious\nNew Merchant IDs\nMerchant\tID\tCategory\nGODIVA\tcmljbphde0000ni5mie0eitc0\tChocolates\nGorjana\tcmljbr4r30000ni7ks05nex93\tJewelry\nMulti-Category Search Example\n\nUser: \"Valentine's gift for my girlfriend, she loves jewelry and chocolate\"\n\nAgent:\n\nPerfect combo! Here's what I'd suggest:\n\n💍 **Jewelry (Gorjana):**\nCampbell Heart Pendant Necklace — $80\nRomantic heart design, 14k gold plated\n→ gorjana.com/products/campbell-heart-pendant-necklace\n\n🍫 **Chocolates (GODIVA):**\nValentine's Day Heart-Shaped Gift Box — $49\n14pc Belgian chocolates in heart box\n→ godiva.com/products/...\n\nTotal: $129 for a memorable combo 💝\n\nChocolate Search\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=valentine+chocolate+gift&merchant_ids=cmljbphde0000ni5mie0eitc0&limit=3\"\n\nJewelry Search\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=heart+necklace+valentine&merchant_ids=cmljbr4r30000ni7ks05nex93&limit=3\"\n\nCategory Routing\nUser mentions:          → Route to:\n\"chocolate\", \"sweet\"    → GODIVA\n\"jewelry\", \"necklace\"   → Gorjana\n\"flowers\", \"roses\"      → Regional florist\n\"supplements\", \"health\" → Avea Life\n\"gift\"                  → Ask or suggest combo\n\nv3.1 - Added Candles\nCategory\tProducts\n🌸 Flowers\t1,058\n🍫 Chocolates\t159\n💍 Jewelry\t236\n🕯️ Candles\t94\n💊 Supplements\t286\nTOTAL\t1,833\nVoluspa Candles\nMerchant ID: cmljbu7xo0000niallngo8vqy\nProducts: 94 luxury candles\nPrice range: $26-275 USD\nBest for: Romantic ambiance, self-care gifts\nCandle Search\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=romantic+candle+gift&merchant_ids=cmljbu7xo0000niallngo8vqy&limit=3\"\n\nv3.2 - Added Fragrances\nUpdated Inventory\nCategory\tMerchant(s)\tProducts\n🌸 Flowers\t5 florists\t1,058\n🍫 Chocolates\tGODIVA\t159\n💍 Jewelry\tGorjana\t236\n🕯️ Candles\tVoluspa\t94\n🧴 Fragrances\tSnif\t17\n💊 Supplements\tAvea Life\t286\nTOTAL\t10 merchants\t1,850\nSnif Fragrances\nMerchant ID: cmljbwqky0000nicu9cunvmnt\nProducts: 17 unique perfumes\nPrice range: $68-135 USD\nBest for: Unique, conversation-starting gifts\nFragrance Search\ncurl -s \"https://dashboard.airshelf.ai/api/search?q=perfume+gift&merchant_ids=cmljbwqky0000nicu9cunvmnt&limit=3\"\n\nv4.0 - Full Gift Suite\nComplete Inventory (2,099 products)\nCategory\tMerchant(s)\tProducts\tPrice Range\n🌸 Flowers\t5 florists\t1,058\t$25-3000\n🍫 Chocolates\tGODIVA\t159\t$24-150\n💍 Jewelry\tGorjana\t236\t$40-890\n⌚ Watches\tDaniel Wellington\t182\t$99-350\n🕯️ Candles\tVoluspa\t94\t$26-275\n🧴 Fragrances\tSnif\t17\t$68-135\n🧔 Men's Grooming\tBeardbrand\t67\t$12-100\n💊 Supplements\tAvea Life\t286\t€29-199\nNew Merchant IDs\nMerchant\tID\tCategory\nDaniel Wellington\tcmljbyt6m0000nifqtav8h5ip\tWatches\nBeardbrand\tcmljbzak80000nig7jbxxquwe\tGrooming\nGender-Smart Routing\n\"gift for boyfriend/husband/him\" → Beardbrand, Daniel Wellington, Snif\n\"gift for girlfriend/wife/her\" → Gorjana, Voluspa, Flowers\n\"gift for partner\" → All categories\n\nGift Combos\n\nRomantic Night In:\n\nVoluspa candle ($48) + Flowers ($75) + GODIVA chocolates ($49) = ~$172\n\nFor Him:\n\nBeardbrand beard oil set ($65) + Daniel Wellington watch ($169) = ~$234\n\nFor Her:\n\nGorjana heart necklace ($80) + Flowers ($90) + Voluspa candle ($48) = ~$218"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/evoleinik/gift-genius",
    "publisherUrl": "https://clawhub.ai/evoleinik/gift-genius",
    "owner": "evoleinik",
    "version": "4.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/gift-genius",
    "downloadUrl": "https://openagent3.xyz/downloads/gift-genius",
    "agentUrl": "https://openagent3.xyz/skills/gift-genius/agent",
    "manifestUrl": "https://openagent3.xyz/skills/gift-genius/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/gift-genius/agent.md"
  }
}