Home / ai-analyst-lab / ai-analyst · .claude/skills/always-compare/SKILL.md · GitHub

always-compare skillA

always-compare is agent-read markdown (skill) from ai-analyst-lab/ai-analyst: Never present a metric or number in isolation; anchor every number to a comparison (prior period, benchmark, or another segment) or state that none is available. Use every time you show a number: rates, counts, revenue, averages, query results, chart labels, summary stats. Trigger on output containing "the rate is", "we saw", "total", "average", "conversion", "revenue", "users", "sessions", "churn", "AOV", "NPS", or any figure pulled from data..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Skill: Always Compare

## Purpose
A number alone is not an insight. "Conversion rate is 3.2%" tells the reader nothing
actionable — they cannot tell if that is a crisis or a record high. This skill enforces
one rule: **every metric ships with a comparison.**

## When to Use
Before presenting ANY number to the user — in chat, in a report, in a chart caption,
in a Slack message, or on a slide. This runs on every analysis output, alongside
`question-framing` (which runs at the start; this one runs at the end).

## The Rule

> **Never show a number alone. Anchor it to at least one comparison.**

Pick the comparison that best serves the decision. In priority order:

| # | Comparison Type | Use When | Example |
|---|---|---|---|
| 1 | **vs. prior period** | The question is "is this changing?" | "down from 4.1% last month" |
| 2 | **vs. benchmark / average** | The question is "is this normal?" | "below the 3.8% site-wide average" |
| 3 | **vs. another segment** | The question is "who is affected?" | "vs. 5.4% on desktop" |

**Two comparisons beat one.** A prior-period delta plus a benchmark tells the reader both
the direction and the altitude. Use both when you have both.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add ai-analyst-lab/ai-analyst/always-compare@git:20260827.7ff2e25
Exact content
mdr add ai-analyst-lab/ai-analyst/always-compare@sha256:e6073d07e1a8639e

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tamzfcddpzhleone.svg)](https://markdownregistry.com/a/art_tamzfcddpzhleone)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260827.7ff2e25 latest2026-08-27 7ff2e25 5,743 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5743 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ai-analyst-lab/ai-analyst · 302 stars · license MIT · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tamzfcddpzhleone
GET https://markdownregistry.com/api/v1/resolve?ref=ai-analyst-lab/ai-analyst/always-compare
GET https://markdownregistry.com/api/v1/blob/e6073d07e1a8639ea7dc538f2e6a4733f02d156607a338d2ea7f62593b887b0c

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from ai-analyst-lab/ai-analyst

analysis-design skill
ai-analyst-lab/ai-analyst · .claude/skills/analysis-design/SKILL.md · Takes a vague analytical hunch, stakeholder request, or business question and produces a rigorous, stakeholder-ready…
git:20260902.b370de6 · audit A · 302 stars
analyst-core skill
ai-analyst-lab/ai-analyst · .claude/skills/analyst-core/SKILL.md · Operating rules for every data analysis. Apply for ANY data-analysis intent: "analyze", "investigate", "why did X…
git:20260921.652dcb5 · audit A · 302 stars
archaeology skill
ai-analyst-lab/ai-analyst · .claude/skills/archaeology/SKILL.md · Retrieve proven SQL patterns, table cheatsheets, and join patterns from .knowledge/query-archaeology/ so past work gets…
git:20260827.7ff2e25 · audit A · 302 stars
archive-analysis skill
ai-analyst-lab/ai-analyst · .claude/skills/archive-analysis/SKILL.md · Save completed analyses to the knowledge system's analysis archive for future reference. Use this skill after…
git:20260902.b370de6 · audit A · 302 stars
auth-preflight skill
ai-analyst-lab/ai-analyst · .claude/skills/auth-preflight/SKILL.md · Verify Google Workspace MCP authentication at the start of any session that needs Google APIs (Docs, Slides, Drive)…
git:20260902.b370de6 · audit A · 302 stars
business skill
ai-analyst-lab/ai-analyst · .claude/skills/business/SKILL.md · Browse, search, and explore your organization's business context system — glossary terms, product catalog, metric…
git:20260902.b370de6 · audit A · 302 stars
causal skill
ai-analyst-lab/ai-analyst · .claude/skills/causal/SKILL.md · Causal inference toolkit for when experiments are not possible: estimate treatment effects from observational data with…
git:20260828.01c26bc · audit A · 302 stars
chart-to-drive skill
ai-analyst-lab/ai-analyst · .claude/skills/chart-to-drive/SKILL.md · Standardized workflow for uploading local chart PNGs to Google Drive and making them available for insertion into…
git:20260827.7ff2e25 · audit A · 302 stars
close-the-loop skill
ai-analyst-lab/ai-analyst · .claude/skills/close-the-loop/SKILL.md · Ensure every analysis that includes a recommendation ends with a clear, actionable follow-up plan. CRITICAL RULE - Only…
git:20260902.b370de6 · audit A · 302 stars
codex-review skill
ai-analyst-lab/ai-analyst · .claude/skills/codex-review/SKILL.md · Independently validate the current analysis with a second model (OpenAI Codex). Codex re-derives the same answer from…
git:20260902.b370de6 · audit A · 302 stars
compare-datasets skill
ai-analyst-lab/ai-analyst · .claude/skills/compare-datasets/SKILL.md · Compare metrics, findings, and patterns across two or more connected datasets. Helps identify cross-dataset patterns…
git:20260902.b370de6 · audit A · 302 stars
connect-data skill
ai-analyst-lab/ai-analyst · .claude/skills/connect-data/SKILL.md · Guided wizard to connect a new dataset to the AI Analyst system. Use this skill whenever the user wants to add a new…
git:20260917.a038f7a · audit A · 302 stars

Every file in ai-analyst-lab/ai-analyst

Browse by kind, by grade A, or by owner.