reloadium.com

showGauge

Show a single score/metric as a gauge (speedometer-style dial) in the chat — for a single 0-N value that means something in context of a range, especially when that range has qualitative zones (poor/fair/good, low/medium/high risk). Use this instead of showChart for one standalone number; use showChart for multiple values or a trend over time. If you already computed a weighted score in this conversation via showComparisonMatrix (an option's weightedTotal) or showProsCons (netScore), reuse that exact number and its `maxPossibleTotal`/horizon range here rather than re-deriving a different one from scratch — this tool is for re-presenting a score you already have, not a second, possibly-inconsistent scoring pass. Provide `value` (required) and optionally `min`/`max` (default 0-100), `unit` (e.g. '%', 'pts'), and `label` (what's being measured, e.g. 'Readability Score'). Optionally provide `zones` — an ascending list of {to, label, color?} where each zone's range is (previous zone's `to`, this zone's `to`], e.g. for a 0-100 risk score: [{"to":40,"label":"Low risk","color":"#22c55e"}, {"to":70,"label":"Medium risk","color":"#f59e0b"}, {"to":100,"label":"High risk","color":"#ef4444"}] — the last zone's `to` should equal `max`. Omit `color` to get an auto-assigned palette; omit `zones` entirely for a plain single-color gauge with no qualitative bands. Only use zones when they reflect a real, meaningful distinction for this specific metric — don't invent arbitrary thirds just to add color.

Page: /

Input schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "value": {
      "type": "number"
    },
    "min": {
      "type": "number",
      "description": "Defaults to 0."
    },
    "max": {
      "type": "number",
      "description": "Defaults to 100."
    },
    "unit": {
      "type": "string"
    },
    "label": {
      "type": "string",
      "description": "What's being measured, e.g. 'Readability Score'."
    },
    "zones": {
      "type": "array",
      "description": "Optional ascending qualitative bands: [{to, label, color?}]. Each zone spans from the previous zone's `to` (or `min` for the first) up to its own `to`. The last zone's `to` should equal `max`.",
      "items": {
        "type": "object",
        "properties": {
          "to": {
            "type": "number"
          },
          "label": {
            "type": "string"
          },
          "color": {
            "type": "string",
            "description": "Optional hex color, e.g. '#22c55e'."
          }
        },
        "required": [
          "to",
          "label"
        ]
      }
    }
  },
  "required": [
    "value"
  ]
}