CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-changes

Review uncommitted or recently committed documentation changes for correctness, coherence, and style compliance. Use before creating a PR to catch issues. "review my changes", "review the diff", "check the fix before submitting", "does this look right".

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 well-structured, lean instruction-only skill: a numbered review workflow with executable git commands, explicit verification actions, and a concrete decision checklist. The only improvements are tightening a few redundant framing sentences and making the more abstract verification steps (code tracing, upstream verification) more concrete.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence (terse bullets, ready-to-run git commands, no explanation of what git or diffs are), matching anchor 4. It is not anchor 5 because a few sentences restate the same point ("Start with no assumptions... not to rubber-stamp the diff" says one thing three ways) and lines like "A change that's correct on its own page can break the story told by a related page" merely recap the preceding bullets.

4 / 5

Actionability

The guidance is mostly executable: exact git commands for each review scope ("git diff --name-only main...HEAD", "git diff --unified=10") and concrete checks (grep for filename/anchors, verify URLs resolve). It stops short of anchor 5 because several verification steps remain high-level direction ("Trace through the common execution path", "verify against upstream docs or source code") without a specific procedure or example.

4 / 5

Workflow Clarity

Steps 1-7 are clearly sequenced (scope, read files, cross-references, factual verification, reader evaluation, code tracing, decision), each verification step is explicit (check URLs resolve, confirm flags exist, check anchor links match heading IDs), and the decision section is a concrete approve/request-changes checklist. This matches anchor 5's clear sequence with explicit validation steps and a checklist; no feedback-loop cap applies since the skill is read-only review, not destructive or batch.

5 / 5

Progressive Disclosure

The body is well organized into clear headed sections with no buried references and no content that obviously belongs in separate files, matching anchor 4's good structure with appropriately placed content. It does not reach anchor 5's fully-split ideal and exceeds the under-50-line simple-skill exception (the body is ~110 lines), though nothing here genuinely needs offloading to reference files.

4 / 5

Total

17

/

20

Passed

Description

80%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 that clearly states what it does, when to use it, and how users would naturally phrase the request. Its main weakness is distinctiveness: the trigger phrases are generic review language that would conflict with a code-review skill, since only the capability clause (not the triggers) mentions documentation.

Suggestions

Scope the trigger phrases to documentation, e.g. "review my doc changes", "check the docs before submitting", so they do not collide with code-review skills.

Add common trigger variations users would say, such as "proofread these docs" or "sanity check the docs before I open the PR".

DimensionReasoningScore

Specificity

The description names a concrete scope ("uncommitted or recently committed documentation changes") and lists three specific evaluation criteria ("correctness, coherence, and style compliance"), giving several concrete actions with only minor coverage gaps. It falls short of anchor 5 because it offers a single review operation rather than multiple distinct concrete actions, and it exceeds anchor 3 since more than 1-2 specific actions/dimensions are explicitly named.

4 / 5

Completeness

Both "what" ("Review uncommitted or recently committed documentation changes for correctness, coherence, and style compliance") and "when" ("Use before creating a PR to catch issues") are explicitly stated, and four concrete trigger phrases ("review my changes", "review the diff", "check the fix before submitting", "does this look right") are included. This clearly matches anchor 5 — both what and when answered explicitly with concrete trigger phrases — and exceeds anchor 4, where the when-clause would be less explicit or lack trigger phrases.

5 / 5

Trigger Term Quality

Four natural, user-spoken trigger phrases are quoted ("review my changes", "review the diff", "check the fix before submitting", "does this look right"), which is good keyword coverage. It is not anchor 5 because common variations such as "proofread", "sanity check", or "review before merging" are missing, while it clearly exceeds anchor 3's partial keyword coverage.

4 / 5

Distinctiveness Conflict Risk

The "what" clause scopes the skill to documentation changes, but the trigger phrases ("review the diff", "review my changes") are unscoped and would equally fire for code-review skills, creating real overlap with closely related skills. This matches anchor 3 (somewhat specific but could still overlap with similar skills) rather than anchor 4, since the most likely trigger phrases are the ones shared with code-review skills.

3 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

docker/docs

Path

.agents/skills/review-changes/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.