CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-review

Use when code changes need review before merge - validates architecture, types, security, and test coverage.

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

86%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 lean, highly actionable review workflow with concrete commands and explicit output taxonomies. The only meaningful gaps are the undefined $SCOPE variable, a missing report format for step 5, and absent error-recovery guidance when automated checks fail.

DimensionReasoningScore

Conciseness

The ~35-line body contains only project-specific knowledge Claude cannot infer (the ARCHITECTURE.md pattern rules, the exact commands) with zero padding or explanation of known concepts, matching anchor 5's 'lean and efficient; every token earns its place'. There is nothing to trim that would not remove information.

5 / 5

Actionability

Concrete, executable commands are given for every automated step (git diff --name-only HEAD~1, npx tsc --noEmit, ng lint, ng test --watch=false) plus explicit classification and verdict taxonomies, matching anchor 4's 'mostly executable guidance with minor gaps'. It falls short of anchor 5 because $SCOPE in step 2b is never defined and step 5 gives no report format or example, leaving two steps not fully copy-paste ready.

4 / 5

Workflow Clarity

Steps 1-5 form a clear sequence with automated checks (tsc, lint, tests, architecture validation) acting as checkpoints and a classification scheme before the verdict, fitting anchor 4's 'clear sequence with most checkpoints present; minor validation gaps'. The destructive/batch cap does not apply (read-only review), but it stays below anchor 5 because there is no error-recovery guidance (e.g. what to do when tests fail) and the 2b/3 numbering disrupts the sequence.

4 / 5

Progressive Disclosure

The skill is under 50 lines, requires no external reference files (verified: no references/, scripts/, or assets/ directories exist in the bundle), and is organized into clear sections, so per the rubric's simple-skill guideline it earns anchor 5. The external pointer to docs/ARCHITECTURE.md is appropriate and one level deep.

5 / 5

Total

18

/

20

Passed

Description

75%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 solid description that explicitly covers both what the skill does and when to use it, with an acceptable set of natural trigger terms. Its main weakness is narrow trigger coverage (no PR/diff/pull-request synonyms) and omission of the skill's output (report and verdict), which leaves it just short of the top anchors.

Suggestions

Broaden the trigger clause to include common synonyms, e.g. 'Use when the user asks to review code, a PR, or a diff before merge'.

Mention the skill's output so the 'what' is complete, e.g. '...and produces a classified report with an Approved / With caveats / Requires changes verdict'.

Clarify the scope hint (types/tests imply an Angular/TypeScript project) to further reduce overlap with generic code-review skills.

DimensionReasoningScore

Specificity

"validates architecture, types, security, and test coverage" lists several concrete validation targets, matching anchor 4's 'several specific actions; minor gaps in coverage'. Not a 5 because key capabilities from the body (producing a report, issuing an Approved/With caveats/Requires changes verdict) are not mentioned, and not a 3 because more than 1-2 concrete actions are named.

4 / 5

Completeness

Both questions are answered: what ("validates architecture, types, security, and test coverage") and when ("Use when code changes need review before merge"). It sits at anchor 4 rather than 5 because the 'when' clause covers a single scenario and lacks the multiple concrete trigger phrases of the anchor 5 example.

4 / 5

Trigger Term Quality

"Use when code changes need review before merge" supplies natural phrases users would say (review, code changes, merge), fitting anchor 4's 'good keyword coverage; a few natural terms missing'. Missing common variations like 'PR', 'pull request', 'diff', or 'code review' itself, which keeps it below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Pre-merge code review is a recognizable niche with distinct triggers, but the description overlaps with generic code-review and linting skills, matching anchor 4's 'mostly distinct; minor overlap risk with closely related skills' rather than anchor 5's minimal conflict risk.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/specialist-agent

Path

packs/angular/skills/review-review/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.