CtrlK
BlogDocsLog inGet started
Tessl Logo

review

Use for focused review of a Neva pull request, branch, diff, or patch.

61

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.codex/skills/review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is a well-structured, token-efficient instruction skill with a clear sequenced workflow, concrete perspective references, and a precise output contract. Progressive disclosure is exemplary, with each perspective cleanly split into real one-level-deep reference files.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence, with a compact workflow and output contract and no explanation of concepts Claude already knows. It is not a 5 because the opening restates the change types already in the description, a minor redundancy that could be trimmed, and not a 3 because there is no padded or unnecessary explanation.

4 / 5

Actionability

Concrete guidance is given via explicit reference files for each perspective (e.g. "references/review-correctness.md") and a precise output contract with severity ordering and file/line references. It is not a 5 because the subagent decision criterion ("based on the change's size and risk") lacks a concrete threshold, and not a 3 because the file references and output rules are specific and executable rather than vague hints.

4 / 5

Workflow Clarity

Five numbered steps form a clear, correctly sequenced workflow with built-in quality checkpoints (deduplication in step 4 and an explicit empty-findings fallback in step 5). It is not a 5 because there is no explicit validation/retry feedback loop, though that is less critical for a read-only review task, and not a 3 because the sequence and checkpoints are clearly defined rather than implicit.

4 / 5

Progressive Disclosure

The body is a concise overview that splits each review perspective into a clearly signaled, one-level-deep reference file (review-correctness.md, review-readability.md, review-performance.md, review-security.md), all of which exist in the bundle, with well-organized sections and easy navigation. It is not a 4 because references are fully clear and content is appropriately split with no nesting or organization gaps.

5 / 5

Total

17

/

20

Passed

Description

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

The description is concise, uses third-person imperative voice, and clearly scopes the skill to Neva code-change review with concrete trigger objects. Its main weakness is that the only action verb ("review") is generic, so capability specificity lags behind trigger quality.

Suggestions

Add one or two concrete review actions to the description, e.g. "...to surface correctness, performance, security, and readability findings".

Include an explicit "Use when the user asks to review a Neva PR, branch, diff, or patch" trigger clause to lift completeness toward 5.

Add a common synonym such as "code review" or "changeset" to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The phrase "focused review" names the domain (code-change review) and concrete targets ("pull request, branch, diff, or patch"), but the only action verb is the generic "review" with no concrete sub-actions, matching the anchor where actions are minimal or generic. It is not a 3 because there is no second concrete action, and not a 1 because the domain and review objects are explicitly named.

2 / 5

Completeness

The "Use for focused review of a Neva pull request, branch, diff, or patch" clause provides both a clear "what" (focused review) and an explicit "when" (Neva PR/branch/diff/patch), matching the anchor where both are present but the trigger could be more specific. It is not a 5 because it lacks a "Use when the user mentions…" style explicit trigger phrase, and not a 3 because the when-clause is explicit rather than merely implied.

4 / 5

Trigger Term Quality

Natural developer terms "pull request", "branch", "diff", "patch", and "review" are exactly what a user would say when requesting this skill, giving good keyword coverage. It is not a 5 because common synonyms like "code review" or "changeset" are absent, and not a 3 because several natural trigger phrases are already present.

4 / 5

Distinctiveness Conflict Risk

The "Neva" scoping plus the specific change types (PR/branch/diff/patch) give it a clear niche with mostly distinct triggers and only minor overlap risk with a generic code-review skill. It is not a 5 because "review" is a broad concept that could still overlap with related review skills, and not a 3 because the Neva qualifier substantially narrows the trigger space.

4 / 5

Total

14

/

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
nevalang/neva
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.