Score card

A score card is the output returned when content is scored against a model. It carries one row per trait plus a composite row. Each trait row packs five signals into a compact view.

§1Definition

A score card is a structured rendering of a scoring result. It contains one row per trait declared on the model and a final row for the composite. The card is the standard display format across the web UI, the text/plain response of the REST API, and the MCP tool output. The underlying JSON response contains the same fields.

§2Anatomy of a trait row

clarity 72
◂ Obscure Clear ▸
Solid — 8 to Strong ●●●
Figure 1. A trait row on a score card. Five numbered signals are identified below.
1
Trait name and score The trait being measured and the numeric score on the 0–100 scale. The score's color reflects the assigned tier.
2
Polarity labels Short strings naming the ends of the trait's axis. They make explicit which direction the score runs.
3
Score bar with next-break marker The filled bar shows the score's position on the axis. The small vertical marker is the next break above the score.
4
Tier label and headroom The tier the score falls into and the headroom to the next tier. "Solid — 8 to Strong" indicates the score is 8 points below the strong break.
5
Confidence indicator Three-dot glyph for the row's confidence level: ●●● high, ●●○ moderate, ●○○ low.

§3The composite row

A score card for a model with multiple traits appends a composite row below the per-trait rows. The composite row reports the single aggregate score, a confidence level (the minimum per-trait confidence), and headroom (the maximum per-trait headroom — the bottleneck trait's gap). It does not carry a tier label. The aggregation rules are defined on the composite page.

§4Edge cases

§4.1Single-trait models

A model with one trait produces a card with one trait row. The composite row is omitted because the composite would equal the single trait's score; no new information would be conveyed.

§4.2Low-confidence rows

When a trait's confidence is low, the row still renders with the numeric score but the tier label is withheld and the next-break marker and headroom are not shown. The confidence indicator makes the reason explicit.

§5Related concepts

  • Tiers — the label shown in the fourth element of each row.
  • Headroom — the distance to the next tier boundary shown in the row and composite.
  • Confidence — the reliability signal rendered as the dot glyph.
  • Composite — the aggregate row at the bottom of the card.
Scores are approximate — not a substitute for human judgment.