CtrlK
BlogDocsLog inGet started
Tessl Logo

review

Review changes relative to a prior state, such as a diff, pull request, branch, commit, or working-tree changes. Use for change-focused code review and regression analysis. Do not use to assess an existing file, API, design, implementation, or other artifact without a comparison; if the request is ambiguous, ask whether the user wants a change review and what prior state to compare against.

70

Quality

88%

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

85%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.

An exceptionally actionable, well-sequenced operational script: exact commands, gates, validation checkpoints, and templates throughout, with no filler. The main weakness is progressive disclosure — two referenced files are absent from the bundle and large persona/rule content is inlined rather than split into reference files.

Suggestions

Ship `api-conventions.md` (and the comparison-base skill or an inline fallback for its logic) in the bundle, since Step 2 and Step 6 both depend on files that are not present.

Move the Breaker and API Analyst personas, severity adjustment table, and report template into a `references/` file (one level deep) to slim SKILL.md to an overview plus orchestration steps.

De-duplicate the empty-diff and size gates between Step 2 and the Edge Cases section to tighten token usage.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and free of concept explanations Claude already knows — every section is operational (gates, commands, tables, templates). Minor trims exist: the empty-diff and >10,000-line gates each appear twice (Step 2 and Edge Cases), and the opening paragraph partially duplicates the Scope Gate. Not 5 due to that minor redundancy; not 3 because there is no padded explanation.

4 / 5

Actionability

Fully executable throughout: exact git commands for local/remote review, batch sizing ('~50 files or ~500 changed lines'), a concrete extracted-section format, sub-agent prompt checklists, exact output-format strings, a complete report template, and explicit verdict rules. Everything needed to run the review is copy-paste ready.

5 / 5

Workflow Clarity

Steps 1-9 are clearly sequenced with validation checkpoints at every stage: mode confirmation with user wait, TaskCreate tracking, empty-diff and size gates, no-code gate, a four-condition high-confidence evidence gate, severity promotion/cap rules, and dedup-before-report. Error-recovery paths (skip mode, sub-agent timeout, comparison-base edge cases) are handled explicitly — matching the top anchor.

5 / 5

Progressive Disclosure

References are clearly signaled and one level deep ('Read `.claude/skills/comparison-base/SKILL.md`', 'Read `api-conventions.md`'), but neither referenced file exists in the bundle (no references/ directory, no api-conventions.md), so both are dangling. Additionally, substantial content that could live in reference files (sub-agent personas, severity rules, report template) is inlined in a ~340-line monolithic SKILL.md. Falls between the 'some structure, content that should be separate is inline' (3) and 'good structure, minor gaps' (4) anchors — the missing bundle files tip it to 3.

3 / 5

Total

17

/

20

Passed

Description

87%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 high-quality description in third person that clearly states what the skill does, when to use it, and when not to use it, with a rich set of natural trigger terms and explicit ambiguity handling. Only minor gains available from adding common synonyms like 'PR' or 'patch'.

Suggestions

Add common synonyms such as 'PR', 'patch', or 'changes' to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

Concrete actions are named — 'Review changes relative to a prior state, such as a diff, pull request, branch, commit, or working-tree changes' plus 'change-focused code review and regression analysis' — covering several specific review targets. Not a 5 because the actions themselves (review, regression analysis) are somewhat generic compared to an enumeration like 'extract text and tables, fill forms, merge documents'.

4 / 5

Completeness

Explicitly answers both questions: the 'what' ('Review changes relative to a prior state... change-focused code review and regression analysis') and the 'when' ('Use for change-focused code review and regression analysis'), with concrete trigger phrases plus explicit negative boundaries and ambiguity handling. Matches the score-5 anchor; not 4 because the 'when' clause is fully explicit rather than implied.

5 / 5

Trigger Term Quality

Strong natural keyword coverage: 'diff', 'pull request', 'branch', 'commit', 'working-tree changes', 'code review', 'regression analysis' — phrases users would actually say. A few common synonyms ('PR', 'changes', 'patch') are missing, so it falls between the 'good coverage' (4) and 'comprehensive with synonyms' (5) anchors, closer to 4.

4 / 5

Distinctiveness Conflict Risk

A clear niche — change review relative to a prior state — with an explicit do-not-use clause ('Do not use to assess an existing file, API, design, implementation, or other artifact without a comparison') that disambiguates it from general assessment skills. Trigger terms (diff, PR, commit) are distinct to this niche; minimal conflict risk.

5 / 5

Total

18

/

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
microsoft/FluidFramework
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.