CtrlK
BlogDocsLog inGet started
Tessl Logo

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".

79

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

The content is a tight, well-sequenced seven-step review workflow with concrete git commands, explicit verification checks, and a decision checklist. It assumes Claude's competence, avoids concept re-teaching, and is appropriately self-contained for a single-purpose instruction skill.

DimensionReasoningScore

Conciseness

The body is lean and directive ("Do not just read the diff... read the entire file", "Don't assume the change is factually correct"), avoids teaching concepts Claude already knows, and every explanatory sentence justifies a non-obvious instruction rather than padding.

3 / 3

Actionability

It provides real executable git commands (git diff --name-only, git diff --unified=10 main...HEAD) and concrete checks (verify against upstream docs, confirm flags/API fields exist, grep for anchors), meeting the level-3 anchor for actionable guidance in an instruction skill.

3 / 3

Workflow Clarity

A clear seven-step sequence (identify, read, cross-references, verify facts, evaluate as reader, review code, decision) ends in an explicit approve/request-changes checklist with verifiable criteria; this is a non-destructive review task so the validate-fix-retry cap does not apply.

3 / 3

Progressive Disclosure

No bundle files exist and the body references none, but the content is organized into well-signaled numbered sections; as a single cohesive workflow that does not need external references, well-organized sections suffice for the level-3 anchor.

3 / 3

Total

12

/

12

Passed

Description

100%

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

The description is specific, third-person, and complete, supplying concrete review actions, an explicit use-when clause, and four realistic trigger phrasings. It carves a clear niche (documentation review before a PR) that is unlikely to conflict with other skills.

DimensionReasoningScore

Specificity

"Review uncommitted or recently committed documentation changes for correctness, coherence, and style compliance" names a concrete domain plus three distinct review actions in third person, matching the level-3 anchor of multiple specific concrete actions.

3 / 3

Completeness

It answers both what (review doc changes for correctness/coherence/style) and when ("Use before creating a PR to catch issues") with explicit triggers, meeting the level-3 anchor; the when clause is explicit, not merely implied.

3 / 3

Trigger Term Quality

Four natural verbatim phrasings are supplied ("review my changes", "review the diff", "check the fix before submitting", "does this look right"), giving good coverage of terms users would actually say rather than just some keywords.

3 / 3

Distinctiveness Conflict Risk

The documentation-changes-pre-PR niche is distinct and scoped narrowly enough to avoid triggering for unrelated skills, matching the level-3 clear-niche anchor.

3 / 3

Total

12

/

12

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.

Validation15 / 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
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.