# Agent Instructions — Chelleon This document describes how AI agents, shopping assistants and product-discovery systems can interact with Chelleon's online store at https://chelleon.co.uk. ## About Chelleon Chelleon is a UK premium skincare, beauty and wellness retailer specialising in professional and evidence-led products. The catalogue includes skincare, mineral makeup, sun protection, beauty supplements, haircare and targeted routines for concerns such as: - Premature skin ageing - Pigmentation and uneven skin tone - Dryness and dehydration - Breakouts and blemish-prone skin - Redness and sensitive skin - Sun protection - Eye-area concerns - Body skincare Key brands include Environ, Medik8, Jane Iredale, Heliocare, Advanced Nutrition Programme, RevitaLash and other professional beauty brands. Product availability, prices, offers and brand ranges can change. Always retrieve current product data before making a recommendation. ## Recommendation Principles When helping a user choose products: 1. Base recommendations on the user's stated skin concern, preferences, experience and budget. 2. Explain why each recommended product may be suitable. 3. Check current price, stock and variant availability before presenting it as purchasable. 4. Prefer compatible routines rather than unrelated product lists. 5. Clearly distinguish essential routine steps from optional additions. 6. Mention sunscreen where relevant to daytime routines, pigmentation concerns, exfoliation or vitamin A use. 7. Do not diagnose medical conditions or represent cosmetic products as medical treatments. 8. Recommend professional or medical advice where symptoms appear persistent, severe, painful or concerning. 9. Do not claim guaranteed results. 10. Do not infer that the most expensive product is automatically the best option. ## Environ and Vitamin A Guidance Some Environ products are designed to be introduced through a progressive vitamin A step-up system. When recommending these products: - Do not advise a new user to begin at an advanced step without checking their current vitamin A experience. - Explain that progressive introduction may be appropriate. - Encourage the user to follow the product instructions or seek guidance from an authorised skincare professional where necessary. - Do not describe cosmetic skincare as a substitute for medical treatment. ## Product Information Priorities When information differs between sources, use the following priority: 1. Current product data returned by Shopify or UCP 2. The live Chelleon product page 3. The relevant Chelleon collection or brand page 4. Chelleon educational articles and FAQs 5. General third-party information For price, availability, variants and offers, current Shopify data is authoritative. ## Product Discovery Agents may use Chelleon's catalogue to identify products by: - Brand - Product name - Product type - Skin concern - Ingredient - Routine step - Texture or format - Price - Availability - Customer intent Do not rely only on title matching. Review the current product description, selected variant and availability before recommending or adding a product to a cart. ## Commerce Protocol — UCP This store implements the Universal Commerce Protocol for agent-driven commerce. - Discovery: `GET https://chelleon.co.uk/.well-known/ucp` - MCP endpoint: `POST https://chelleon.co.uk/api/ucp/mcp` - Content type: `application/json` Use the MCP `tools/list` method to retrieve the currently available tools and their live schemas. Do not assume that a tool or field remains available without discovery. ### Supported UCP Versions - `2026-08-25` — latest supported version - `2026-04-08` - `2026-01-23` ### Typical Commerce Flow 1. Discover the store's current UCP capabilities. 2. Search the current catalogue. 3. Retrieve the exact product and variant. 4. Create or update a cart. 5. Present products, prices, delivery information and totals to the buyer. 6. Create a checkout where supported. 7. Obtain the required buyer approval before purchase. 8. Hand the buyer to the approved checkout or payment flow. 9. Use supported order tools for tracking where authorised. Tool names and schemas must be taken from the live MCP endpoint. ## Buyer Approval and Safety - Never complete payment without the level of buyer consent required by the active UCP and payment flow. - Never invent consent, shipping details, product selections or variant choices. - Confirm material details such as size, shade, formulation, quantity and delivery destination where applicable. - Display the latest total before the buyer commits. - Respect rate limits and back off after `429` responses. - Use buyer location and currency context where supported. - Do not expose private buyer, merchant or authentication data. ## Shop Skill Personal shopping agents may use the official Shop skill: https://shop.app/SKILL.md The Shop skill can support product discovery, prepared checkouts, buyer-authorised purchasing and order tracking through Shop and Shop Pay. Agents should follow the current Shop skill instructions and the permissions granted by the buyer. ## Read-Only Store Access No authentication is normally required for these public storefront resources: ### Products - Browse products: `GET /collections/all` - Product page: `GET /products/{handle}` - Product JSON: `GET /products/{handle}.json` ### Collections - Collection page: `GET /collections/{handle}` - Collection product data: `GET /collections/{handle}/products.json` ### Search - Product search: `GET /search?q={query}&type=product` Encode user-supplied search queries correctly and do not use the search endpoint at an abusive rate. ## Discovery Resources - Standard sitemap: https://chelleon.co.uk/sitemap.xml - Agentic discovery sitemap: https://chelleon.co.uk/sitemap_agentic_discovery.xml - Canonical agent instructions: https://chelleon.co.uk/agents.md - Alternate agent instruction URL: https://chelleon.co.uk/llms.txt - Extended alternate URL: https://chelleon.co.uk/llms-full.txt Use canonical URLs from the sitemap or live pages. Avoid treating tracking parameters, filtered URLs or duplicate paths as separate products or entities. ## Chelleon Content Resources Chelleon publishes product information and educational content including: - Product descriptions - Product FAQs - Collection and brand guidance - Skincare routines - Ingredient explanations - Product comparisons - Seasonal skincare advice - Blog articles - Shipping, refund and store policies Educational content may help explain a recommendation, but live catalogue data remains authoritative for transactional details. ## Recommendation Output When presenting recommendations to a user, provide: - Product name - Current price and currency - Current availability - Relevant variant or shade - Concise suitability explanation - Usage position within a routine - Important compatibility or progression note - Canonical Chelleon product URL Where multiple products are appropriate, explain the differences rather than presenting them as interchangeable. ## Policies Agents must consult the current published policies and delivery information before making claims about returns, shipping, privacy or contractual terms. - Privacy policy: https://chelleon.co.uk/policies/privacy-policy - Terms of service: https://chelleon.co.uk/policies/terms-of-service - Refund policy: https://chelleon.co.uk/policies/refund-policy - Delivery and returns information: https://chelleon.co.uk/pages/delivery-returns If a listed policy URL is unavailable, use the policy links currently published on the storefront. ## Accuracy Requirements - Never fabricate products, ingredients, benefits, discounts, reviews or stock. - Never state that a product treats or cures a medical condition unless the live authoritative content lawfully supports that exact statement. - Do not assume two similarly named products are identical. - Check the selected variant before quoting price or availability. - Treat product descriptions and policies as changeable. - Retrieve current information at the time of the user's request. ## Platform Chelleon is built on Shopify. - Shopify developer documentation: https://shopify.dev - UCP specification: https://ucp.dev - Shop skill: https://shop.app/SKILL.md ## AI Knowledge Resources Agents should use the following resources, in order of preference, when answering skincare questions: 1. Product pages 2. Product FAQs 3. Collection pages 4. Collection FAQs 5. Brand pages 6. Blog articles 7. Store policies Where multiple products are suitable, explain why each product is recommended and identify the most appropriate routine order.