honest-metrics-auditlisted

# Honest Metrics Audit ## Install Save this file as `~/.claude/skills/honest-metrics-audit/SKILL.md`, or `.claude/skills/honest-metrics-audit/SKILL.md` to scope it to one repo. Claude Code auto-discovers it. Invoke with `/honest-metrics-audit` or by asking "do the numbers on this page actually mean what they say?". ## Why this exists Nobody sets out to publish a false number. It happens because a label and a query drift apart. Someone computes `items.filter(i => i.seller.verified).length`, which is a count of ITEMS. Someone else renders it under the label "Verified sellers". Both lines are individually reasonable. Together they tell every visitor there are fifteen verified sellers when there is one. No test fails, because no test knows what the label says. This is worse than an ordinary bug in one specific way: it is indistinguishable from lying. A visitor who discovers it does not conclude you made a mistake. And for anything that looks like traction (users, downloads, revenue, reviews) an overstated number is the single fastest way to lose the trust you were trying to build with it. ## Step 1: Inventory every displayed number Find the components that render figures: ``` rg -n "toLocaleString|formatCount|formatStat|Intl\.NumberFormat|CountUp|\.length\}" \ --type-add 'ui:*.{tsx,jsx,vue,svelte}' -t ui ``` Also find the labels themselves, which is often faster: ``` rg -n "(users|customers|sellers|buyers|members|downloads|installs|reviews|ratings|sales|revenue|activ