Is the BlockWatch skill free?

Yes. The skill itself is free from mennanov/blockwatch. SkillProof publishes the install command and an independent test verdict at no cost.

What is the BlockWatch SkillProof Score?

9.2/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 10/10, docs & honesty 3/5.

How do I install BlockWatch?

Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.

Can I use BlockWatch with Cursor, Copilot, Gemini CLI, Codex or other AI tools?

The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.

BlockWatch

Real Rust linter that catches code/docs drift via <block affects=...> comment tags -- verified with the actual built binary, not just reading the source.

by mennanov · mennanov/blockwatch

Tested · Works

Install — copy the command Download source ↗

Test report

Verdict: Tested · Works
Score: 9.2/10
Tested: Jul 15, 2026
Environment: Claude Code 2.x (agent harness)
Upstream re-checked: Aug 10, 2026 · dcd9679

Installed the real binary via `brew install mennanov/blockwatch/blockwatch` (trusted formula, built in 1s) and ran a full A/B in a throwaway git repo: a naive baseline edit added a language to a Python list but silently forgot the matching README line with zero warning, while the skill-guided edit added `<block affects=...>` tags in the same change, kept both files in sync, passed `git diff --patch | blockwatch` (exit 0), and then correctly caught a follow-up naive edit with a precise 'is modified, but README.md:supported-langs is not' violation (exit 1) -- but SKILL.md's claim that bare `blockwatch` (no diff piped) 'validates every block in the tree' is false, verified empirically: with an unsorted keep-sorted list and no diff on stdin it silently exits 0, contradicting the tool's own --help text and its own 'only validated when touched by a diff' sentence elsewhere in the same file.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

Installs cleanly 5/5
Triggers reliably 5/5
Output vs. baseline 10/10
Docs & honesty 3/5

What BlockWatch does

A language-agnostic linter (Rust CLI, installable via cargo or brew) that validates HTML-like <block> tags placed in source-file comments: keep-sorted/keep-unique lists, line-pattern/line-count constraints, and affects links that force a paired file (e.g. an enum and its README table) to change together. Triggers when writing or editing code in a project that already uses BlockWatch, or when a file already contains <block ...> tags; the skill tells the agent to add tags in the same edit that introduces a guardable pattern and to verify with `git diff --patch | blockwatch`.

How to install BlockWatch

git clone https://github.com/mennanov/blockwatch
cd blockwatch
mkdir -p ~/.claude/skills
cp -r .agents/skills/blockwatch ~/.claude/skills/blockwatch

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger BlockWatch

/blockwatch Real Rust linter that catches code/docs drift via <block affects=...> comment tags -- verified with the actual built binary, not just reading the source.

It also activates on plain-language prompts like these:

Add a block tag so this Python list stays in sync with README docs
I added a new item to this enum, check if the docs need updating too
Verify my code changes with blockwatch before I commit this diff

Frequently asked questions

Is the BlockWatch skill free?: Yes. The skill itself is free from mennanov/blockwatch. SkillProof publishes the install command and an independent test verdict at no cost.
Does BlockWatch work with Claude Code?: We tested it with Claude Code 2.x (agent harness) on Jul 15, 2026. Verdict: Tested · Works. Installed the real binary via `brew install mennanov/blockwatch/blockwatch` (trusted formula, built in 1s) and ran a full A/B in a throwaway git repo: a naive baseline edit added a language to a Python list but silently forgot the matching README line with zero warning, while the skill-guided edit added `<block affects=...>` tags in the same change, kept both files in sync, passed `git diff --patch | blockwatch` (exit 0), and then correctly caught a follow-up naive edit with a precise 'is modified, but README.md:supported-langs is not' violation (exit 1) -- but SKILL.md's claim that bare `blockwatch` (no diff piped) 'validates every block in the tree' is false, verified empirically: with an unsorted keep-sorted list and no diff on stdin it silently exits 0, contradicting the tool's own --help text and its own 'only validated when touched by a diff' sentence elsewhere in the same file.
What is the BlockWatch SkillProof Score?: 9.2/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 10/10, docs & honesty 3/5.
How do I install BlockWatch?: Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use BlockWatch with Cursor, Copilot, Gemini CLI, Codex or other AI tools?: The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.