report-card

Solid

Render a finished BS report as a self-contained HTML page — score hero, filterable claims, readable on a phone, prints to a clean PDF. Use when the user wants to open, share, print, or show a report to someone who is not going to read a markdown table, or asks for "the HTML version", "something I can send", "a shareable page", or "make this readable".

Data & Documents 142 stars 10 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 85/100

Stars 20%
72
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# report-card Turn `bs-report-<slug>-<date>.md` into one HTML file anybody can open. The markdown is the artifact and stays the artifact — it is what `tally.py` checks, what gets diffed against a later run, and what gets committed. This skill adds a **reader-facing** view of that same file. It renders; it never edits, recounts, or adds. Every number on the page is copied from the markdown verbatim. ## Why this exists A BS report is a five-column claims table. On a laptop that is fine. On a phone — which is where a shared link is actually opened — the Evidence column is unreadable, and the reader's first question ("what's wrong with it?") means scrolling twenty rows to find the two that matter. ## Usage ```bash uv run <this-skill-dir>/scripts/render_report.py ~/.bullshit-detector/reports/<YYYY>/bs-report-<slug>-<date>.md ``` Writes `bs-report-<slug>-<date>.html` beside the markdown. `-o <path>` puts it elsewhere. No install step, no dependencies — the script is stdlib-only, runs under plain `python3` as well as `uv run`, and the page it produces makes no network requests. That combination is what lets it work in a code-execution sandbox, where the HTML is the only thing the user can take away. - `--open` shows the page in the default browser. Where there is no browser — a sandbox, a headless host — it says so and the file is still written. **It is skipped when the page already exists**, because re-rendering is normal (the run line gets finalised after a first pass)...

Details

Author
SerhiiKorniienko
Repository
SerhiiKorniienko/bullshit-detector
Created
1 months ago
Last Updated
1 weeks ago
Language
Python
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category