CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-docs

Use when reviewing the documentation a branch changes — AGENTS.md, READMEs and pages under wiki/ — or sweeping the whole wiki with --full. Cross-checks every claim a page makes against the code, finds wikilinks and heading anchors the branch broke, checks frontmatter and page shape, and reports D-C/H/M/L findings in the four-field format.

75

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is review-docs in englishstreetventures/osn

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tightly written, highly operational skill: every step ships runnable commands, validation is built in at both ends, and detail is properly offloaded to a real one-level reference file. The only cost of its dense style is occasional rhetorical justification that could be cut without losing guidance.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no explanations of git, wikis, or Obsidian basics — and nearly every sentence carries operational content. A few rhetorical justifications ("A run that leaves a differently-shaped file has produced nothing, however good the review inside it"; "a page that is tidy but contradicts the code is the worst failure this review exists to catch") are trimmable padding, placing it just below the every-token-earns-its-place anchor.

4 / 5

Actionability

Commands are copy-paste ready throughout: the verbatim `cat > DOCS-REVIEW.md` heredoc skeleton, the `comm -23` wikilink pipeline with full sed/sort stages, the `git grep` cross-check patterns, and the final `grep -c` verification commands. The template placeholders (`<page>`) are inherent parameters, not pseudocode.

5 / 5

Workflow Clarity

Steps 0–5 are explicitly sequenced with a write-the-skeleton-first checkpoint, an edit-never-rewrite rule as an error-recovery loop, graceful degradation when the Obsidian MCP is absent, and a closing validation gate ("Both must print 3") that interprets both failure directions. This is a read-only review with validation present, so the missing-validation cap does not apply.

5 / 5

Progressive Disclosure

The branch-diff procedure lives in the body while the per-section detail is split to a single, clearly signaled, one-level-deep reference — "The full per-section checklist — currency, bloat, aids, structure, frontmatter, links, hygiene — is in `references/checklist.md`" — and the referenced file exists and matches that description. The split is deliberate: SKILL.md for the procedure, the checklist for a --full sweep.

5 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it names the target artifacts, the two invocation modes (branch diff vs --full sweep), and every major capability of the skill in concrete terms. The only weakness is a slightly thin set of synonyms ("docs", "markdown") for trigger matching.

DimensionReasoningScore

Specificity

The description lists four concrete actions — "Cross-checks every claim a page makes against the code", "finds wikilinks and heading anchors the branch broke", "checks frontmatter and page shape", "reports D-C/H/M/L findings in the four-field format" — covering the skill's full workflow with no gaps, matching the comprehensive-coverage anchor.

5 / 5

Completeness

It explicitly answers both questions with concrete trigger phrases: the "what" is the four named actions, and the "when" is "Use when reviewing the documentation a branch changes … or sweeping the whole wiki with --full". This matches the anchor requiring both what and when with explicit trigger guidance, not merely present.

5 / 5

Trigger Term Quality

Natural terms a user would say are present — "reviewing the documentation", "AGENTS.md", "READMEs", "wiki/", "wikilinks", "frontmatter" — but common synonyms like "docs", "markdown", or the ".md" extension are absent. Good coverage with a few natural terms missing, so it sits above the midpoint rather than at the comprehensive anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche — documentation review of a branch's changes in a wiki-bearing repo — with distinct triggers (AGENTS.md, wiki/, wikilinks, --full) that sibling skills like code or security review would not claim. Minimal conflict risk with other skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

englishstreetventures/englishstreetventures.com

Path

.claude/skills/review-docs/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.