CtrlK
BlogDocsLog inGet started
Tessl Logo

roborev-review-branch

Use only when the user explicitly invokes $roborev-review-branch

56

Quality

62%

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

Fix and improve this skill with Tessl

tessl review fix ./internal/skills/codex/roborev-review-branch/SKILL.md
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.

The body is a tight, actionable procedural guide with a clearly sequenced workflow, explicit input validation, and error-recovery feedback loops. Its main limitation is minor boilerplate and template placeholders rather than fully copy-paste-ready commands; progressive disclosure is sound but has no references to exercise.

DimensionReasoningScore

Conciseness

The body is mostly efficient commands and concrete steps with little padding; only minor instances could be trimmed, such as the 'guidelines, not a rigid script' boilerplate and the conceptual sandbox-access prose, matching 'Efficient; minor instances of over-explanation that could be trimmed.' Not 5 because of those small trimmable passages; not 3 because the bulk is tight and actionable.

4 / 5

Actionability

Provides concrete executable commands ('roborev review --branch --wait ...') and a copy-paste base-branch snippet with 'git rev-parse --verify', plus worked examples with real job ids, matching 'Mostly executable guidance; concrete code or commands with minor gaps.' Not 5 because some options are shown as template placeholders ('[--type <type>]') with conditional framing rather than a single ready command.

4 / 5

Workflow Clarity

A clear 4-step sequence (validate -> run -> present -> offer next steps) with an explicit validation checkpoint ('git rev-parse --verify', 'If validation fails ... Do not proceed') and error-recovery feedback loops (suggest 'roborev status'/'roborev init'/re-run, and offer '$roborev-fix'), matching 'Clear sequence with explicit validation steps; feedback loops for error recovery.' Not 4 because both validation and recovery loops are explicitly present; the destructive/batch cap does not apply since this is a read-only review.

5 / 5

Progressive Disclosure

Well-organized into clear sections (Usage, Instructions with numbered subsections, Examples, See also) and self-contained with no bundle files present, so navigation is easy and nothing is buried, matching 'Good structure; most content is appropriately placed; minor organization gaps.' Not 5 because there are no one-level-deep references to signal (none are needed), so it does not demonstrate the reference-splitting the top anchor rewards.

4 / 5

Total

17

/

20

Passed

Description

43%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 a deliberate, well-gated invocation trigger with excellent distinctiveness, but it omits any explicit statement of what the skill does and offers minimal action specificity. It answers 'when' clearly but leaves 'what' only implied by the skill name.

Suggestions

Add a concrete 'what' clause, e.g. 'Requests a roborev code review for all commits on the current branch and presents the verdict and findings. Use only when the user explicitly invokes $roborev-review-branch.'

Include a few natural trigger synonyms/variations (e.g. 'review', 'audit', or 'inspect this branch') so the description captures how users phrase the request, while keeping the explicit-invocation gate.

DimensionReasoningScore

Specificity

The description names the domain and a minimal action via the invocation token '$roborev-review-branch' (review + branch), but the prose itself states no concrete capability beyond the 'Use only when' gate, matching 'Names the domain but actions are minimal or generic.' Not 3 because no additional concrete actions are listed; not 1 because the token does name the action and domain rather than being entirely vague.

2 / 5

Completeness

The description gives an explicit 'when' ('Use only when the user explicitly invokes $roborev-review-branch') but no explicit 'what' statement of capability; the action is only implied by the token, matching 'only when is present without what.' Not 3 because the 'what' is not clearly stated, only weakly implied by the name.

2 / 5

Trigger Term Quality

Natural keywords 'review' and 'branch' appear in the invocation token, but there is no coverage of common synonyms or variations a user might say (audit, inspect, check commits, PR), matching 'Some relevant keywords but missing common variations or synonyms.' Not 4 because only two relevant terms are present with no broader coverage.

3 / 5

Distinctiveness Conflict Risk

Triggering is gated to a single named invocation token ('$roborev-review-branch') with an explicit-invocation requirement, giving a clear niche with minimal conflict risk. Not below 5 because no other skill would match this exact explicit trigger.

5 / 5

Total

12

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
roborev-dev/roborev
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.