doc-test-alignment — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited doc-test-alignment (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
This skill is a stub. The real workflow is intentionally not yet implemented — the file exists so that steward verify can find it and so contributors who land here know it is on the roadmap, not forgotten.
scripts/check.sh is the entry point. Today it prints a not-yet-implemented notice and exits non-zero. When the workflow lands, the script will gate PR-readiness on the alignment contract below; until then, treat any green exit code from this script as a bug.
The skill is the contract for four narrow alignments. README.md command examples must still execute against the current checkout and produce output that matches the surrounding prose. The "build/test/publish" command lines in CLAUDE.md must do the same. For each .claude/skills/<name>/, the SKILL.md description frontmatter must agree with what the scripts under scripts/ actually do — surfacing disagreements (e.g. SKILL.md claims the skill bumps versions but scripts/ has no bump script). And for each test, the test name should still describe the assertions the test makes — flagging drift where the name advertises a feature the assertions no longer touch.
Each of those four checks is independently non-trivial. Shipping a partial implementation would either silently pass when it shouldn't, or false-positive on intentional doc-vs-code differences. The right path is to land the checks one at a time, with their own tests, behind a steward verify --check doc-test-alignment flag. The parent verbs (verify, doctor) are named in the "Roadmap" section of CLAUDE.md; the broader sibling-pattern contract lives in docs/sibling-pattern.md.
steward verify's skills-convention checkfinds the standard layout (SKILL.md + scripts/ with an entry-point).
scripts/check.sh is the entry-point script, satisfying the steward skillsconvention requirement that every skill ships an executable script.
SKILL.md is the contract for what the skill will do — when theimplementation lands, it must satisfy this description or the description must move first.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.