1---2name: claim-check3description: >-4 Finds every number, comparison, quote and research claim in a draft and checks each against the company's approved5 claims in company-profile.md or a source the reader can open, then marks it verified, unsupported, unsourced or6 forbidden and returns PASS or FAIL with the fix for each. Use it before any page, post, ad or email with a number or7 a "best"-style claim goes out, and as the check step inside skills that write copy. Not for tone or wording8 (use voice-check).9license: MIT10compatibility: >-11 Works in Claude, ChatGPT, Codex, Cursor and any agent that reads SKILL.md. Opens sources if the agent can browse;12 otherwise asks the reader to paste the source text. Python 3 is optional, for finding claims.13metadata:14 author: SHAKEUP15 version: "1.0.0"16 stage: check17 plugin: start-here18 homepage: https://www.shakeuphq.com/skills/claim-check19---20 21# Claim check22 23Makes sure every number and claim in a draft is backed by something a skeptical buyer could open.24 25## Purpose26 27- One job: list every checkable claim in one draft and give each a status and a fix.28- Stage: check. It ends in PASS or FAIL.29- It never makes a claim true by finding a source that sort of agrees. A source must state the claim, for the same thing, in the same period.30 31## Use when / not32 33| Situation | Use |34| --- | --- |35| A draft has numbers, comparisons, quotes or "research shows" | this skill |36| Another skill reaches its check step on copy | this skill, after `voice-check` |37| The wording is off but the facts are fine | `voice-check` |38| Adding new claims to the company's approved list | `company-profile`, mode `update` |39 40## Inputs41 42| Input | Required | Ways to provide, in order | If missing |43| --- | --- | --- | --- |44| The draft | yes | a file the agent can read; pasted text | ask for it |45| Approved claims | no | `## Claims and proof` in `company-profile.md` | every first-party claim is `unsourced` until the reader gives a source |46| Sources for external claims | no | links in the draft (opened in this run); source text the reader pastes | the claim is `unverified`; ask for the source |47 48## Profile read49 50`## Claims and proof` (each approved claim, its source, checked and expiry dates), `### Never say`, `## Competitors` (mention policy), and `## Learnings` entries for `claim-check`.51 52No profile: treat every first-party number as `unsourced` and ask the reader for its source, in one message listing them all.53 54## Steps55 561. **Apply learnings** for this skill.57 582. **Find the claims.** Run `scripts/find_claims.py --draft draft.md`. Without Python, read every sentence and pick out: numbers with %, x, times or a currency; comparisons (more than, faster than, the best, #1, industry-leading, leading); quoted passages; "according to", "studies show", "research shows"; and any year next to one of those. Also catch claims the pattern misses: "trusted by thousands", "used by top teams", "proven". List every one with its line.59 603. **Sort each claim.**61 62 | Type | Means | Needs |63 | --- | --- | --- |64 | First-party | about the company, its product or customers | a match in `## Claims and proof` |65 | External | a fact about the market or the world | a source opened in this run, or text the reader pastes |66 | Competitor | about a named competitor | a public source, and the profile's mention policy allows it |67 | Customer quote | words from a customer | a match in `## Claims and proof` or the reader's confirmation it is cleared for use |68 | Opinion | clearly framed as the company's view ("we think") | nothing; not a claim |69 704. **Check first-party claims** against the profile. A match must be the same number, about the same thing, for the same period. Then check the dates: past `Expires` is `expired`; `Checked` over 12 months ago is a warning.71 725. **Check external claims.** Open the source. Find the sentence that states the claim. Run `scripts/find_claims.py --claim "<claim>" --source <source text file>` as a first filter: under 30% of the claim's words in the source means it's very likely unsupported. Passing the filter isn't proof: read the sentence and confirm the number, the subject, the period and the population match. Record the excerpt.73 74 | Source problem | Status |75 | --- | --- |76 | The page doesn't state the claim | `unsupported` |77 | It states it for a different group, market or year | `unsupported`, and say what it does state |78 | The source cites another source | follow it once; cite the original |79 | It can't be opened (paywall, 403, dead link) | `unverified`; ask the reader for the text |80 | It's the vendor's own marketing about itself | allowed, but say "according to <vendor>" |81 826. **Check what may never be said.** Any match to `### Never say`, or a competitor claim the mention policy doesn't allow, is `forbidden`.83 847. **Write the fix** for each claim that isn't verified:85 86 | Status | Fix |87 | --- | --- |88 | `unsupported` | Replace with what the source does say, or cut the number |89 | `unsourced` | Ask for the source; until then, cut the number or turn it into the mechanism ("cuts the steps from 6 to 2" if that is a fact about the product) |90 | `unverified` | Ask for the source text; keep the claim out until it's checked |91 | `expired` | Ask for a current figure, or date the claim ("in 2024, ...") if the source still stands |92 | `forbidden` | Cut it |93 | vague superlative ("the best", "leading") | Replace with the specific proof behind it, or cut |94 95## Check and verdict96 97Severity: `critical` (unsupported, forbidden, unsourced first-party number, expired), `warning` (unverified, a vague superlative, a source checked over 12 months ago), `suggestion` (a verified claim whose sentence could cite its source more clearly).98 99| Verdict | Condition (first match wins) |100| --- | --- |101| `BLOCKED` | No draft |102| `FAIL` | Any critical finding |103| `PASS WITH NOTES` | Warnings or suggestions only |104| `PASS` | Every claim verified or opinion |105 106No named stops. The calling skill fixes and reruns.107 108## Learn109 110- A source the reader confirms for a first-party claim: add the claim to `## Claims and proof` with its source and today's date, and record a `fact` learning.111- A source that turned out wrong or dead: record a `fact` learning naming the source, so later runs don't trust it.112 113## Output114 115```116Verdict: <PASS | PASS WITH NOTES | FAIL | BLOCKED> · Coverage: <complete | partial (sources not opened: n)>117Claims found: <n> · verified <n> · unsupported <n> · unsourced <n> · unverified <n> · forbidden <n> · expired <n>118 119| Line | Claim | Type | Status | Evidence or problem | Fix |120(critical first; for verified claims, the source and a short excerpt)121```122 123Then the handoff block.124 125## Hand off126 127```handoff128skill: claim-check129version: 1.0.0130verdict: FAIL131coverage: partial (2 sources behind a paywall)132for: <draft name>133outputs:134 critical: 1135 verified: 6136 needs_source: ["Teams cut CAC by 23%"]137next: []138open: [source for "Teams cut CAC by 23%"]139```140 141## Failure modes142 143| Problem | Do this |144| --- | --- |145| The draft cites "internal data" | Treat as first-party: it must be in `## Claims and proof` |146| A number is rounded differently from the source (24% vs 23.7%) | Verified if rounding is normal; flag a rounding up of a range ("up to 40%" from "20 to 40%") as unsupported |147| An AI answer engine is the "source" | Not a source. Find the page it cited |148| The same claim appears several times | Check it once; list every line |149| A testimonial is paraphrased | It's no longer a quote: remove the quotation marks or use the cleared original |150 151## Influenced by152 153- SHAKEUP's content engine, where no number reaches an article unless its source was fetched and checked in the same run.154- Google's Search Quality Rater Guidelines on trust, which treat unsupported and misleading claims as a sign of low quality: https://guidelines.raterhub.com/searchqualityevaluatorguidelines.pdf