Sandbox
@SerhiiKorniienko/bullshit-detector

Claim-checking skills for Claude Code and other agents

This repo packages agent skills that extract claims from a source, search for evidence, and write a verdict for each claim with citations. It also includes ingestion skills for turning URLs and files into text, and publishing skills for turning the result into a shareable report.

142 stars10 forksPythonUpdated 16d ago
Who it's for

Builders who want Claude Code, Codex, Cursor, Gemini CLI, or Copilot to fact-check content before they act on it.

What it delivers

You can turn a viral link or draft into a sourced report instead of relying on model memory or vibes.

What it does

Claim-by-claim verification

Extracts individual claims from a source and checks each one against independent sources.

BS score and verdicts

Returns a 0–10 BS score plus verdicts like confirmed, plausible, misleading, false, or unverifiable.

Source-aware ingestion

Fetches YouTube transcripts, TikTok captions, articles, PDFs, tweets, and local text into normalized content.

Publishing outputs

Can turn findings into HTML reports and social-ready shareable output.

Portable skill format

Uses markdown skills and self-contained Python so the bundle can move across supported agents and editors.

How to get it

  1. 1Run the skills.sh installer and pick the skills and agents you want
    npx skills@latest add SerhiiKorniienko/bullshit-detector
  2. 2Prefer a managed bundle that updates when a new version ships, instead of copied files…
    /plugin marketplace add SerhiiKorniienko/bullshit-detector
    /plugin install bullshit-detector@serhii-korniienko

README

Bullshit Detector

skills.sh License: MIT checks

Launching soon on TinyLaunch

BS REPORT — bullshit-detector. Point your agent at a video, article, tweet or PDF. Get every claim back, checked, scored, and sourced. Verdicts: confirmed, plausible, misleading, false, unverifiable. No source, no verdict — not even when the model is sure.BS REPORT — bullshit-detector. Point your agent at a video, article, tweet or PDF. Get every claim back, checked, scored, and sourced. Verdicts: confirmed, plausible, misleading, false, unverifiable. No source, no verdict — not even when the model is sure.

Read a real report → — 60 claims from a 2.7M-view "the AI bubble is popping" video, 44 of them individually searched, every verdict linked.

Agent skills that fact-check the internet. Point your agent at a viral YouTube video, article, tweet, or PDF — get a claim-by-claim verification report with sources and a BS score (0–10) instead of taking "10 WAYS TO MAKE MONEY WITH AI 🤯" at face value.

Portable Agent Skills — plain markdown + self-contained Python. They work in Claude Code, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Zed, and any harness that supports the skills format and has web search. No terminal? Claude Cowork installs the whole bundle from a GitHub URL.

Built in the open with Claude Code — an AI helped build the tool that fact-checks AI hype, and the example report is it auditing its own kind.

Installed it? GitHub can tell you when it changes. Every new skill and rule change ships as a release. Click Watch → Custom → Releases at the top of this page and GitHub emails you each one. A star is a silent bookmark; that is the setting that actually notifies you. No signup, no list, nothing to unsubscribe from.

Prefer something else? Follow @SerhiiFounder, or join the newsletter.

Quickstart

  1. Install uv if you don't have it (the fetch script uses it to self-resolve its dependencies).

  2. Run the skills.sh installer and pick the skills and agents you want:

npx skills@latest add SerhiiKorniienko/bullshit-detector
  1. Ask your agent: "is this bullshit? <url>", "fact-check this video", "summarize <url>", "explain the part at 12:30".

Install as a Claude Code plugin

Prefer a managed bundle that updates when a new version ships, instead of copied files you maintain yourself? Inside Claude Code:

/plugin marketplace add SerhiiKorniienko/bullshit-detector
/plugin install bullshit-detector@serhii-korniienko

Two ways to install, two philosophies:

  • skills.sh copies the skills into your setup so you can hack on them and make them your own. Works with any agent (Claude Code, Codex, Copilot, Cursor, Gemini CLI, OpenCode, …).
  • The plugin keeps them as a read-only, always-current bundle — best when you just want it to work and follow along as it evolves. Claude Code and Claude Cowork.

Pick one, not both — installing both gives Claude Code two copies of every skill.

What works where

Rows are the things you'd ask for, columns are where you're asking. Step-by-step setup per app lives in SETUP.md.

You ask for…Claude Code
CLI / Code tab
Claude Cowork
no terminal
Claude Chat
claude.ai / desktop
Coding agents
Codex, Copilot, Cursor, Gemini, …
"is this bullshit?" — a YouTube or TikTok link✅ with the Chrome connector on⚠️ paste the transcript
— an article, tweet, or PDF✅ paste or attach if a site blocks Claude
— a draft or any text you paste
Summarize or explain it instead
An HTML report card you can send✅ download before closing✅ download before closing
Social posts + image carousel❌ needs your machine❌ needs your machine

The Claude Code and Cowork columns are field-tested (real runs, latest 14 Aug 2026). The Chat and coding-agent columns are what each platform's docs support — if a cell lies to you, that's a bug, tell me. Coding agents need to be able to run scripts and search the web — per-agent specifics in SETUP.md.

Per-app walkthroughs: Claude Code · Cowork · Chat · Codex · ChatGPT · Copilot · Cursor · Gemini CLI · everything else

Why These Skills Exist

#1: Viral ≠ true

A finance guy with 1M views tells you the "only 14 ways to make money with AI". How much of it is real? Views, production value, and confidence are not evidence. The fix is boring: extract every claim, check each against independent sources, and score what survives. That's exactly the work agents with web search are good at and humans never bother doing.

The fix: bullshit-detector — per-claim verdicts (✅ confirmed / 🟡 plausible / 🟠 misleading / ❌ false / ❓ unverifiable), a hype-signal scan, an incentive analysis ("who benefits if you believe this"), and a 0–10 BS score. Verdicts require sources — the skill forbids confirming or refuting from model memory alone.

#2: Agents can't watch videos

Your agent can't sit through a 27-minute video, and YouTube's official API won't give you captions for videos you don't own. Same story with tweets, where the official API now bills per post, and with paywalled articles.

The fix: fetch-content — one script that turns any URL into clean text + metadata with no API keys: YouTube transcripts and TikTok captions via yt-dlp, articles via readability extraction, PDFs, tweets via free endpoints. Every failure mode produces an actionable hint (paywall → paste, no captions → Whisper) instead of a silent guess.

#3: Separation of fetching and judging

Ingestion and analysis are different jobs. Scripts do the deterministic work (fetch, parse, normalize); the agent does the reasoning (extract claims, search, judge). Because analysis skills only ever see normalized text + metadata, adding TikTok support one day touches zero analysis logic — and the same detector works on a tweet and a 3-hour podcast.

Example

A real run against a 1.16M-view "make money with AI" video: examples/0.4.x/report-14-ways-to-make-money-with-ai.md.

BS score: 5/10 — real tools, real trends, guru math, and a funnel every four minutes. 12 claims verified: 4 confirmed, 2 plausible, 3 misleading, 0 false, 3 unverifiable. Among the catches: "Renaissance, D.E. Shaw, Two Sigma only trade employees' money" (true for one fund of one firm), and marketplace stats sourced from the marketplace's own PR.

And a TikTok run — a 552K-view "our Sun has a hidden twin" video: examples/0.4.x/report-second-sun-binary-star.md (BS score: 9/10 — real astronomy vocabulary stitched onto a fabricated cosmology).

A 137K-view "$1M YouTube channel in 1 hour a day" video — examples/0.5.0/report-1m-youtube-channel.md (BS score: 7/10). The advice is fine and unremarkable; the headline "$76,000 per video" turns out to be total business revenue divided by videos published. Every proof point is a number only the seller can see, which the report says plainly rather than pretending to have audited it.

And the awkward one: a 43K-view video arguing the AI buildout is about to collapse, checked by a tool built with Claude — examples/0.5.0/report-claude-situation-shitshow.md (BS score: 5/10). The reporting holds up; the arithmetic behind its headline number is roughly double reality. The claim it rates ❌ false is also the one most favourable to Anthropic, so the report carries a conflict-of-interest disclosure and links every source to check it against.

Someone on Hacker News asked for the obvious test — run it on this README. examples/0.4.x/report-own-readme.md (BS score: 3/10). It caught a two-year-stale API price and a "30-second setup" that began with installing a package manager, both fixed in v0.4.2, and one thing that can't be fixed by editing: the only evidence this tool is accurate is reports it wrote about videos its author picked.

Check your own draft before you publish

The detector runs on any text, including yours. Point it at a post, README, or launch announcement you're about to ship — "fact-check my draft" — and it flags the claims a hostile reader would go after first, with the source that fixes each one. Cheaper than a correction.

That's how examples/0.4.x/report-own-readme.md exists: someone on Hacker News asked for it live, and it found a two-year-stale API price before more people did.

What it doesn't do

Honest limits, because a tool like this earns nothing by overselling itself:

  • It checks premises, not reasoning. Every claim can verify clean and the conclusion still not follow. A false fact gets caught; a bad inference drawn from true facts sails straight through. If you want the argument audited rather than the facts, this is the wrong tool.
  • It can only cite what it can reach. Many high-reputation outlets block agent crawlers entirely, so they never appear in results — and SEO content marketing ranks in the gap. Their reporting sometimes re-enters quoted secondhand by an aggregator, which looks like an independent source and isn't. The measurements are here; it's worse than I assumed before running them.
  • It has a measured score, and the score is not good. On a ten-case corpus of 480 hand-labelled claims it found 70% of the curated claims, confirmed 69% of the claims known to be true against a 95% target, caught 69% of the claims known to be false, and rated 2 true claims false. Same content, three runs: half the claims changed verdict at least once. The full reading, per case, with what it does and does not mean, is in eval/RESULTS.md; the labels are drafts pending owner review and the evidence base is not frozen, so the verdict columns carry retrieval noise. This narrows the circularity its own self-audit flagged (labels written by the same author who picked the content); it does not remove it. Tracked as #3.
  • Verdicts vary between runs. Web search is non-deterministic; the same query minutes apart can return a mostly different evidence base. Treat a single report as one reading, not a measurement.

Experiments

Tests of the detector's own behaviour, published whichever way they land — see experiments/. Most recent: does telling it to "use credible sources" help? (asked for on Hacker News; the answer is "I can't tell yet, and here's the more interesting thing I hit instead").

TikTok videos

Yes, TikTok works — ask the same way: "is this bullshit? https://vt.tiktok.com/…".

How it works under the hood:

  1. Built-in captions first. Most TikToks ship with creator or auto-generated captions. The fetch-content script handles this natively — TikTok URLs (including vt.tiktok.com short links) return a timestamped transcript plus views/likes/reposts, no video download. The same thing by hand:

    uvx yt-dlp --list-subs <tiktok-url>                                  # check what's available
    uvx yt-dlp --write-subs --sub-langs "eng-US" --skip-download <tiktok-url>  # grab the .vtt
    
  2. No captions? Whisper fallback. For caption-less TikToks and Reels there's a validated local-transcription prototype (mlx-whisper on Apple Silicon, no system ffmpeg needed — PyAV decodes the audio) graduating from skills/in-progress as the transcribe skill. Use whisper-large-v3-turbo — smaller models garble words badly enough to break claim extraction.

The analysis side doesn't care either way — the detector sees normalized text + metadata whether it came from a 7-minute TikTok or a 3-hour podcast (that's design principle #3).

Reference

All skills are model-invoked: you can call them explicitly, and the agent also reaches for them when your request fits ("is this legit?" triggers the detector).

Analysis

Reason about content. Source-agnostic — they never care where the text came from.

  • bullshit-detector — Extract every claim, verify each against independent sources via web search, scan for hype signals, produce a report card with per-claim verdicts and a 0–10 BS score.
  • summarize — Structured TLDR with timestamped key points, notable quotes, and an honest "worth your time?" call.
  • explain — ELI5 → deep-dive explanation of the content or any concept in it, with a jargon glossary and the prerequisites the original assumes.

Ingestion

Turn any source into clean text + metadata.

  • fetch-content — YouTube transcripts, TikTok captions, articles, PDFs, tweets, local files. One script, auto-detects source, no API keys.
  • coverage-check — Counts the independent origins behind news coverage of a claim, collapsing reprints and wire copy into one source. Turns "40 outlets confirmed it" into "one press release, reprinted 40 times". GDELT, no API key.

Publishing

Turn reports into shareable output.

  • report-card — The report as one self-contained HTML page you can send to someone who won't read a markdown table: score hero, filter to just the ❌ and 🟠, claims as cards on a phone, clean print-to-PDF. Stdlib only — no dependencies, no install step.
  • share — Ready-to-paste posts for X (thread/single), LinkedIn, Facebook, Reddit, Hacker News, or a newsletter — plus a branded image carousel: 1080×1350 PNGs for X/Instagram and the PDF that LinkedIn document posts want.

Roadmap

See skills/in-progress: compare (same topic across sources — who's right?), transcribe (Whisper for caption-less TikTok/Reels — working mlx-whisper prototype landed, SKILL.md pending), X thread walking.

Stay in touch

I'm building these skills in the open — new detectors, adapters, and real fact-check reports as they land.

License

MIT

Files in the repo

Repository payload16 top-level entries
  • .claude-plugin
  • .github
  • agents
  • assets
  • eval
  • examples
  • experiments
  • scripts
  • skills
  • .gitignore
  • AGENTS.md
  • CLAUDE.md
  • CONTEXT.md
  • LICENSE
  • README.md
  • SETUP.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

57k
ayghri/
i-have-adhd

A skill to stop your coding agent from burying the answer. ADHD-friendly output.

38k