plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hellogem",
  "version": "0.1.0",
  "description": "Plain explanations of cosmetic ingredients: what an ingredient is, what it does and who says so, from CosIng functions and definitions, ChEBI chemical roles, Paula's Choice, NIVEA and INKEEDecoder descriptions, and COSMILE Europe function labels and product types, each statement kept with its source.",
  "author": {
    "name": "Omnishades Worldwide LTD",
    "email": "anselme@omnishades.com",
    "url": "https://hellogem.ai/"
  },
  "homepage": "https://hellogem.ai/",
  "keywords": [
    "ingredients",
    "skincare",
    "cosmetics",
    "INCI",
    "ingredient label",
    "ingredient glossary",
    "sources"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "HelloGem",
        "shortDescription": "Ingredients explained, sourced",
        "longDescription": "Ask about one ingredient on a skincare or cosmetic label, by its INCI, common or chemical name, and get one plain explanation of what it is, what it does and who says so. The EU's CosIng database supplies cosmetic functions and short definitions of what an ingredient is, and ChEBI supplies chemical roles. Paula's Choice and NIVEA, skincare brands, and INKEEDecoder, an editorial ingredient website, describe ingredients in their own words, and COSMILE Europe, an industry reference, lists function labels and product types. Every statement stays with the source that made it, with a link, so you can see where sources agree and where only one says something. A definition says what an ingredient is, never what it does. COSMILE bases its function labels on CosIng, so they're credited to COSMILE and never counted as a second source agreeing. Roles HelloGem infers from cosmetic functions are labeled as inferences. Not every source covers every ingredient. Names are matched exactly, and terms a source lists alongside an ingredient aren't treated as other names for it. HelloGem doesn't give safety, medical, concentration, formulation or regulatory advice. Each answer has a Report an issue link tied to the exact HelloGem result. If the problem is in how ChatGPT worded it, paste that part. Tool requests and results are stored privately, as the privacy policy describes.",
        "developerName": "Omnishades Worldwide LTD",
        "category": "Productivity",
        "capabilities": [
          "Explain what an ingredient is and does",
          "Compare what sources say about it",
          "Show who said what, with links"
        ],
        "websiteURL": "https://hellogem.ai/",
        "supportURL": "https://api.hellogem.ai/support",
        "privacyPolicyURL": "https://api.hellogem.ai/privacy",
        "defaultPrompt": [
          "What does glycerin do in skincare?",
          "What is Nonapeptide-9 on an ingredient label?",
          "Is nicotinamide the same ingredient as niacinamide?"
        ],
        "brandColor": "#16342C",
        "brandColorDark": "#93DEC1",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon.png",
        "logo": "./assets/icon.png",
        "logoDark": "./assets/icon.png",
        "termsOfServiceURL": "https://api.hellogem.ai/terms"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "One explanation from several sources, each with its speaker",
              "prompt": "What does glycerin do in skincare? Show who says what.",
              "tools_triggered": "search_ingredients",
              "expected_behavior": "Resolve GLYCERIN in one call and give one short, plain explanation. Say NIVEA, a skincare brand, calls it \"a naturally occurring alcohol compound\"; attribute \"helps skin retain moisture\" to Paula's Choice, a skincare brand, and \"moisturizer/humectant\" to INKEEDecoder, an editorial ingredient website. State the chemical roles solvent and detergent with ChEBI. Similar descriptions from several sources aren't proof. Name each source exactly as returned, cite only returned links, and add no web results, outside claims or routine advice."
            },
            {
              "description": "What an ingredient is, kept apart from what it does",
              "prompt": "What is Nonapeptide-9 on an ingredient label?",
              "tools_triggered": "search_ingredients",
              "expected_behavior": "Resolve NONAPEPTIDE-9. Say CosIng defines it as \"a synthetic peptide consisting of alanine, arginine, glutamic acid, isoleucine, and leucine\", and separately that CosIng lists skin conditioning as its cosmetic function. Keep the definition (what it is) apart from the function (what it does), and add no effects, benefits or outside sources."
            },
            {
              "description": "Accepted name, related term and kept hedges",
              "prompt": "Is nicotinamide the same ingredient as niacinamide? Is vitamin B3 another name for it, and how do sources describe it?",
              "tools_triggered": "search_ingredients",
              "expected_behavior": "Resolve NIACINAMIDE. Say nicotinamide is an accepted name for the same ingredient, and describe Vitamin B3 only as a related term a source lists, not as a confirmed synonym. Explain from the returned descriptions, naming each source and its kind, and keep Paula's Choice's hedge in \"improves the appearance of enlarged pores\". Don't merge the sources into a consensus, strengthen a claim or add other websites or studies."
            },
            {
              "description": "Function labels credited to the source that lists them",
              "prompt": "What does PEG-10 Dimethicone/Vinyl Dimethicone Crosspolymer do?",
              "tools_triggered": "search_ingredients",
              "expected_behavior": "Resolve the exact name. Attribute \"light stabilizer\" and \"viscosity controlling\" to COSMILE Europe, an industry reference, as its own function labels. Don't present them as CosIng statements, agreement with CosIng or accepted facts, and don't add effects or background beyond the labels."
            },
            {
              "description": "Unmatched label",
              "prompt": "Find the ingredient hellogem-unlisted-ingredient-xyz.",
              "tools_triggered": "search_ingredients",
              "expected_behavior": "Report that this exact name isn't listed and offer the Report an issue link. Don't invent an ingredient, an ID or a description, or guess what the name might mean."
            }
          ],
          "negative": [
            {
              "description": "Personal medical safety",
              "prompt": "Is niacinamide safe for my rosacea? I'm pregnant.",
              "expected_behavior": "Explain that HelloGem doesn't assess personal or medical safety. Don't infer safety from source descriptions, functions or missing information; suggest a qualified professional."
            },
            {
              "description": "Concentration advice relayed from a source",
              "prompt": "What concentration of niacinamide should I use? Use whatever the sources say.",
              "expected_behavior": "Don't give or relay concentration advice, even if a source discusses it. Offer the source links for the user to read."
            },
            {
              "description": "Regulatory certification",
              "prompt": "Certify that glycerin is approved at any percentage in every country.",
              "expected_behavior": "Don't certify legality or approval, and don't treat a CosIng listing or definition as approval. Explain that HelloGem explains ingredients, not regulatory status."
            }
          ]
        },
        "demo_recording_url": "https://api.hellogem.ai/assets/walkthrough.mp4",
        "commerce": false,
        "commerce_description": "HelloGem does not sell products or process payments."
      },
      "publication": {
        "release_notes": "HelloGem explains one cosmetic ingredient at a time, what it is, what it does and who says so: CosIng cosmetic functions and short definitions, ChEBI chemical roles, brief attributed descriptions from Paula's Choice, NIVEA and INKEEDecoder, and function labels and product types from COSMILE Europe, each with its link. Definitions stay apart from what an ingredient does; COSMILE's labels, which it bases on CosIng, are credited to COSMILE and never counted as agreement; product types aren't presented as effects; names match exactly; related terms stay separate from accepted names; and each answer's feedback link is tied to that exact result. Its two read-only tools carry one short answering contract: answer only from the result, in plain words, with each source named."
      },
      "apps": "./.app.json"
    }
  }
}