Home / wangchangxin0809 / cc-repo-harness · shared/skills/writing-checks/SKILL.md · GitHub

writing-checks skillA

writing-checks is agent-read markdown (skill) from wangchangxin0809/cc-repo-harness: Enforce a convention with machinery instead of prose: PreToolUse guards that refuse an action before it runs, gates that judge the worktree in CI, selftests that prove a check can turn red, layering tests. Use when a written rule keeps being violated, when adding any lint or CI step, when asked to protect a branch or stop a destructive command, or when a check exists that nobody has seen fail..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Guards and gates

Governs: shared/scripts/guards/, shared/scripts/gates/

Two mechanisms, one discipline. A **guard** reads one proposed action before it
runs and may block it. A **gate** reads the worktree at CI time and may fail the
build. Everything below applies to both, because the failure modes are the same.

| | Guard | Gate |
|---|---|---|
| Sees | one tool call, as JSON on stdin | the whole tree |
| Cost | every matching call | once per run |
| Use when | the action is irreversible | the state is detectable |
| Failure | exit 2, stderr goes to the model | non-zero, output goes to a human |

## A guard is a speed bump, not a boundary

Say this out loud before writing one, because the rest of this skill reads like
a promise it cannot keep. A guard matches the *text* of a proposed command:

```
git push origin main | tail -5          BLOCKED
B=push; git $B origin main | tail -5    allowed
```

It also fails open on purpose — a broken guard must not become an unbypassable
wall — so its coverage is best-effort in two independent directions. That is the
right trade for what a guard is actually for: catching the thing you were about
…

Read the whole file at its exact version.

How to install

Latest version
mdr add wangchangxin0809/cc-repo-harness/writing-checks@git:20260903.c1a383c
Exact content
mdr add wangchangxin0809/cc-repo-harness/writing-checks@sha256:1090068d9a82f028

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_dr5caoc2orlnv2x6.svg)](https://markdownregistry.com/a/art_dr5caoc2orlnv2x6)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260903.c1a383c latest2026-09-03 c1a383c 12,503 BA view · diff
git:20260902.801d6092026-09-02 801d609 12,636 BA view · diff
git:20260902.653e3d02026-09-02 653e3d0 12,631 BA view · diff
git:20260901.a1c3abe2026-09-01 a1c3abe 12,358 BA view · diff
git:20260831.21be7192026-08-31 21be719 12,314 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12503 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

wangchangxin0809/cc-repo-harness · 5 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dr5caoc2orlnv2x6
GET https://markdownregistry.com/api/v1/resolve?ref=wangchangxin0809/cc-repo-harness/writing-checks
GET https://markdownregistry.com/api/v1/blob/1090068d9a82f02861457a5fd25557bcb71c0e9ad14fcb649d2f05c86126c4bb

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from wangchangxin0809/cc-repo-harness

CLAUDE.md claude
wangchangxin0809/cc-repo-harness · CLAUDE.md
git:20260902.af30b21 · audit A · 5 stars
CLAUDE.md@shared/scripts claude
wangchangxin0809/cc-repo-harness · shared/scripts/CLAUDE.md
git:20260903.face858 · audit A · 5 stars
CLAUDE.md@shared/skills claude
wangchangxin0809/cc-repo-harness · shared/skills/CLAUDE.md
git:20260902.f0e19e0 · audit A · 5 stars
consolidating-notes skill
wangchangxin0809/cc-repo-harness · shared/skills/consolidating-notes/SKILL.md · Fold a pile of agent notes, memories or scratch files back into the repository: freeze the input, synthesize…
git:20260903.c1a383c · audit A · 5 stars
find-skill skill
wangchangxin0809/cc-repo-harness · shared/skills/find-skill/SKILL.md · Find a Claude Code skill or plugin somebody else has already written, and judge whether to install it. Use before…
git:20260903.c1a383c · audit A · 5 stars
github-surface skill
wangchangxin0809/cc-repo-harness · shared/skills/github-surface/SKILL.md · Write what GitHub itself reads: README, CONTRIBUTING, the community-health files (SECURITY, CODE_OF_CONDUCT, LICENSE…
git:20260903.c1a383c · audit A · 5 stars
project-memory skill
wangchangxin0809/cc-repo-harness · shared/skills/project-memory/SKILL.md · Use when recalling project decisions, remembering reusable discoveries, consolidating memory, or withdrawing outdated…
git:20260922.d26f46b · audit A · 5 stars
repo-index skill
wangchangxin0809/cc-repo-harness · shared/skills/repo-index/SKILL.md · Query the repository's own graph before grepping: which modules, files and documents a symbol, an import or a Governs…
git:20260903.c1a383c · audit A · 5 stars
writing-docs skill
wangchangxin0809/cc-repo-harness · shared/skills/writing-docs/SKILL.md · Write or restructure documentation agents and people actually read: which of the four directories it belongs in…
git:20260903.c1a383c · audit A · 5 stars
bootstrap-repo-harness skill
wangchangxin0809/cc-repo-harness · skills/bootstrap-repo-harness/SKILL.md · Lay a repository's agent harness: CLAUDE.md, hooks, docs/, gates, guards. Use when an agent repeats a mistake or a…
git:20260903.a42ab40 · audit A · 5 stars

Every file in wangchangxin0809/cc-repo-harness

Browse by kind, by grade A, or by owner.