supplement-scorerlisted

# Supplement scorer Turns a supplement product into auditable scores on **formula**, **quality**, and **safety** (0-100 each, plus an overall). The numbers come from a deterministic engine, never from your own estimation — so the same product always gets the same score, and every number is explainable. ## Workflow ### 1. Build the product into this schema Gather the product from whatever the user gave you — a pasted ingredient list, a described product, or a supplement-facts photo (read the label; estimate doses you can't read cleanly and say so). ```json { "name": "Gentle Iron + Folate", "brand": "Acme", "certifications": ["GMP", "third_party_tested"], "ingredients": [ {"name": "Iron", "nutrient": "iron", "form": "ferrous bisglycinate", "amount": 18, "unit": "mg"} ] } ``` `nutrient` must be a key from `references/ingredients.json` (iron, folate, vitamin_d, vitamin_b12, vitamin_b6, vitamin_c, vitamin_e, vitamin_a, vitamin_k, calcium, magnesium, zinc, iodine, choline, omega3_epa_dha, melatonin, creatine, coq10, ashwagandha, collagen). For an ingredient with no matching key, still include it with its `name`; the engine reports it as not-yet-covered. ### 2. Run the engine (never invent scores) ```bash python {skill_dir}/scripts/score.py --json '{...the product json...}' ``` Add `--pregnant` if the user is pregnant or nursing. The script prints JSON with `formula`, `quality`, `safety`, `overall`, `flags`, `unknown`, `coverage`, `rationale`, and `disclaimer`