Revised 9 November 2026 · v1.0.0 · what changed

Code: github.com/herrrickshaw/blog-consistency-check

Watch the walkthrough

Watch on YouTube: youtu.be/05JQ4VNF0cc

Why it is useful

• Who benefits: anyone who hand-writes or bulk-edits HTML blog posts with embedded CSS/JS and cannot eyeball every post after every edit.
• What it replaces: screenshot-diff services ask whether a page changed; this asks whether it is broken, which suits posts that rarely change after publishing.
• Evidence from the run: auditing one live post took a few seconds with only curl and node and produced a 10-rule table plus a plain-language list of failures.
• The run found a real BLOCKER (dark palette with no light-mode lock) on a recent post, so the rules do fire on current content.

What it is for

blog-consistency-check is a checker for masaladeutsch.blogspot.com. It lists posts through the public Blogger feed, downloads each page with curl, and applies a fixed set of static rules. An optional Playwright pass adds computed-contrast and overflow checks in light and dark mode.

The rules encode defects that actually happened on the live blog. CHECKLIST.md explains each one, so the checklist and the code stay in step. The repo also has fix.py and helper scripts for repairing the problems; this post covers only the read-only audit.

Who it is for

• Bloggers who publish self-contained HTML posts with their own CSS and JavaScript
• Maintainers who bulk-edit posts with scripts and want a safety net
• Anyone who wants a CI gate that exits non-zero on broken posts

What you need

Get the code and an AI assistant

You do not have to be a programmer. Get the repository, give it to an AI assistant, and ask in plain language. Any of these routes works:

git clone https://github.com/herrrickshaw/blog-consistency-check.git
cd blog-consistency-check
claude      # or: gemini

Install

1. Clone the repository.

   git clone https://github.com/herrrickshaw/blog-consistency-check.git
   cd blog-consistency-check

2. No packages are needed for the static pass. Check the two tools it shells out to.

   which curl node

Quick start: commands and what you should see

Audit one public post (static pass).

python3 audit.py --url https://masaladeutsch.blogspot.com/2026/10/how-to-use-ship2shorerag-offline.html

It writes out/report.md and out/report.json, prints the report path, and prints a count of BLOCKER failures. The exit code is non-zero when a blocker fails.

Read the report.

cat out/report.md

A rule-summary table (failing vs checked) followed by a list of posts needing attention, each failure tagged BLOCKER, MAJOR or MINOR.

Sample outputs

Real output from a run on the date shown in the sources line; trimmed to fit.

Rule summary for one live post

python3 audit.py --url <post URL>   # then: cat out/report.md
posts audited: 1 · posts with at least one failure: 1

| severity | rule | failing | checked |
| BLOCKER | dark-vars-locked | 1 | 1 |
| BLOCKER | js-parses | 0 | 1 |
| BLOCKER | no-disclaimer-in-script | 0 | 1 |
| BLOCKER | no-inverted-media-query | 0 | 1 |
| MAJOR | wpi-attribution | 0 | 1 |
| MAJOR | disclaimer-present | 0 | 1 |
| MINOR | bw-override | 1 | 1 |
| MINOR | translate-widget | 0 | 1 |
| MINOR | index-link | 0 | 1 |
| MINOR | table-units-in-header | 0 | 1 |

Table reformatted slightly for width. Run on 19 October 2026.

Failure detail and exit summary

tail of the same report
### how-to-use-ship2shorerag-offline.html
- BLOCKER dark-vars-locked: dark palette consumed with no !important light lock
- MINOR bw-override: dark palette present with no BW-override / light lock

1 BLOCKER failures

These are findings about the page's CSS, not about its content. Whether it is a real visual problem is a human call; the contrast pass (--rendered) would confirm it.

Ways to use it

Sample prompts for your AI assistant

Copy, paste and edit the parts in [brackets].

• Claude: Read audit.py and checks.py in this repo and explain each rule in one sentence, then tell me which ones are specific to masaladeutsch.
• Gemini: Run python3 audit.py --url <my post URL> and summarise out/report.md in plain English, ordered by severity.
• ChatGPT: Here is out/report.md. For each failing rule, explain what the reader would see and suggest the smallest CSS change.
• GitHub Copilot: Add a new static rule to checks.py that flags images without alt text, with a matching CHECKLIST.md entry.
• Claude: Adapt this audit to my own blog by listing which constants and rules I would need to change.

Limits and honest caveats

Sources: README, CHECKLIST.md, audit.py and checks.py in github.com/herrrickshaw/blog-consistency-check; static audit run read-only on 19 October 2026 against one already-public masaladeutsch post, in a scratchpad clone.

About this article: Researched, written and edited by Umashankar Triplicane Dwarakanathan, with AI research assistance; every figure is meant to trace to the primary source cited. See the Editorial Policy for how sourcing, AI use and corrections work.