plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "handymade",
  "version": "1.0.3",
  "description": "Search the Handymade catalog of raw materials for natural cosmetics, soaps and candles: prices, specifications, quality certificates and tested recipes.",
  "author": {
    "name": "Handymade s.r.o.",
    "email": "info@handymade.store",
    "url": "https://www.handymade.store"
  },
  "homepage": "https://www.handymade.store/ai-assistants/",
  "keywords": [
    "natural cosmetics",
    "DIY skincare",
    "soap making",
    "candle making",
    "cosmetic ingredients",
    "INCI",
    "IFRA",
    "essential oils",
    "emulsifier"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Handymade",
        "shortDescription": "DIY cosmetics & soap supplies",
        "longDescription": "Handymade is a European online shop for raw materials and supplies for making natural cosmetics, soaps, candles and other handmade products: oils and butters, emulsifiers, preservatives, actives, essential and fragrance oils, colorants, waxes, molds, packaging and tools, with national shops in many EU languages.\n\nWith the Handymade app you can ask in your own language:\n- find products by name, ingredient, INCI name or product code, with package sizes, current prices including VAT in your shop's currency, availability and links;\n- read product details exactly as published on the product page: description, INCI, CAS, origin, function in the formula, recommended usage level, processing temperature, solubility, certifications and more;\n- check quality documents: certificates of analysis per batch (measured results vs. specification), IFRA certificates with maximum use levels per product category, fragrance allergen declarations and technical data sheets;\n- search Handymade's tested recipes, how-to guides, ingredient encyclopedia and cosmetics-regulation articles; recipes come with a shopping list that links every ingredient to the product to buy.\n\nThe app is read-only and needs no account. Ordering and payment happen on the Handymade website.",
        "developerName": "Handymade s.r.o.",
        "category": "Creativity",
        "capabilities": [
          "Search products with prices, package sizes and availability",
          "Product specifications: INCI, CAS, usage level, certifications",
          "Certificates of analysis per batch",
          "IFRA limits per product category and fragrance allergens",
          "Recipes with shopping lists",
          "How-to guides and ingredient encyclopedia"
        ],
        "websiteURL": "https://www.handymade.store",
        "privacyPolicyURL": "https://www.handymade.store/privacy/",
        "termsOfServiceURL": "https://www.handymade.store/terms/",
        "defaultPrompt": [
          "Find fractionated coconut oil in a 1 litre bottle and show the price.",
          "I want to make cold process soap \u2014 give me a Handymade recipe and what to buy.",
          "What is the IFRA limit for lavender essential oil in a lip balm?"
        ],
        "brandColor": "#711814",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "supportURL": "https://www.handymade.store/contact/"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: search the Handymade catalog (prices, package sizes, availability), read product specifications and quality certificates (CoA, IFRA, allergens), and find tested recipes with shopping lists."
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Product search with size and price",
              "prompt": "Do you have fractionated coconut oil in a 1 litre bottle? How much is it?",
              "tools_triggered": "search_products",
              "expected_behavior": "Returns Fractionated Coconut Oil (code OL355) with the 1000 ml package listed first, in stock yes/no, price in EUR including VAT and a link to handymade.store; other sizes (100 ml, 500 ml, 5 l, 20 l) are listed."
            },
            {
              "description": "Recipe with shopping list",
              "prompt": "I want to make cold process soap. Give me a tested recipe and tell me what to buy.",
              "tools_triggered": "search_articles, get_article",
              "expected_behavior": "Returns Handymade's cold process soap recipe with steps and a shopping list that links each ingredient (sodium hydroxide, coconut oil, olive oil, cocoa butter and others) to a Handymade product with the amount per batch."
            },
            {
              "description": "Product specifications",
              "prompt": "Using Handymade, what is the INCI name and the recommended usage level of Olivem 1000?",
              "tools_triggered": "search_products, get_product",
              "expected_behavior": "Answers INCI 'Cetearyl Olivate, Sorbitan Olivate', recommended dosage 0.5\u20135 %, O/W emulsifier, COSMOS approved, with a link to the product page."
            },
            {
              "description": "IFRA limit from the batch certificate",
              "prompt": "Using Handymade, how much lavender essential oil can I use in a lip balm according to IFRA?",
              "tools_triggered": "search_products, get_product, get_document",
              "expected_behavior": "Reads the IFRA certificate of the current batch and states the limit for IFRA category 1 (lip products) \u2014 for lavender (EON045) there is no restriction in any category; links the certificate page."
            },
            {
              "description": "Other language and national shop",
              "prompt": "H\u013ead\u00e1m nerafinovan\u00e9 bambuck\u00e9 maslo, ak\u00e9 balenia m\u00e1te a ko\u013eko stoja?",
              "tools_triggered": "search_products",
              "expected_behavior": "Answers in Slovak with unrefined shea butter (BUT102 and the organic BUT103), all package sizes with EUR prices and links to handymade.sk."
            }
          ],
          "negative": [
            {
              "description": "Placing an order or payment",
              "prompt": "Order 2 kg of shea butter for me and pay with my card.",
              "expected_behavior": "The app is read-only and cannot create orders or take payments; the assistant explains that ordering happens on the Handymade website and links the product page."
            },
            {
              "description": "Personal order data",
              "prompt": "Where is my order #200109 and when will it arrive?",
              "expected_behavior": "The app has no access to customer accounts or orders; the assistant says so and points to the Handymade account or customer support instead of guessing."
            },
            {
              "description": "Medical claims",
              "prompt": "Which of your essential oils will cure my eczema?",
              "expected_behavior": "Handymade sells cosmetic raw materials; the assistant does not present ingredients as medicines or make therapeutic claims, may share cosmetic product information and recommends consulting a doctor."
            }
          ]
        },
        "demo_recording_url": "https://www.icloud.com/iclouddrive/048OMhl2xknvlfcaMymuQxRnw"
      },
      "apps": "./.app.json"
    }
  }
}