CtrlK
BlogDocsLog inGet started
Tessl Logo

roborev-review-branch

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

58

Quality

73%

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/droid/roborev-review-branch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 strong operational skill document: fully executable commands, a well-sequenced workflow with explicit validation and error-recovery loops, and genuinely non-obvious domain knowledge (sandbox escalation, panel synthesis jobs, remote-ref recovery). The only notable weakness is that the long inline bash snippet could live in a bundle file for a cleaner overview.

DimensionReasoningScore

Conciseness

The body is efficient: every section carries non-obvious operational information (sandbox escalation, remote-ref recovery, panel synthesis semantics) and there is no explanation of concepts Claude already knows. Minor trimmable padding exists — the "These instructions are guidelines, not a rigid script" paragraph and some redundancy between the Usage synopsis, the header of Instructions, and the Examples — so it sits just below the 'lean and efficient; every token earns its place' anchor.

4 / 5

Actionability

The skill provides copy-paste-ready executable commands: the exact default invocation `roborev review --branch --wait`, a complete 30-line executable bash snippet for base-branch validation with a real recovery path, and worked examples covering the default and base+type cases. This matches the 'fully executable; copy-paste ready; specific examples cover the common cases' anchor; not 4 because there are no meaningful gaps in the guidance.

5 / 5

Workflow Clarity

The four-step workflow has an explicit validation checkpoint ("If validation fails, inform the user the ref is invalid and report the git error. Do not proceed."), error-recovery feedback loops for command failures (suggest `roborev status`, `roborev init`, re-run), and clear conditional handling for panels and next steps. This matches the anchor 'clear sequence with explicit validation steps; feedback loops for error recovery'; not 4 because both validation and recovery are fully present.

5 / 5

Progressive Disclosure

No bundle files exist and the body is organized with clear, well-ordered sections plus a See-also list, so navigation is easy. However, the ~30-line inline base-branch bash snippet is exactly the kind of content a scripts/ or references/ file could hold out of the main flow, so structure is good but not optimal — matching 'good structure; most content is appropriately placed; minor organization gaps' rather than the ideal split.

4 / 5

Total

18

/

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 functions well as a strict trigger guard but fails as a capability summary: a reader cannot learn from it what the skill does. The guard phrasing is deliberate (explicit-invocation-only policy), but the 'what' half of a good description is entirely missing.

Suggestions

State the capability alongside the trigger, e.g. "Requests a 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" — this would lift completeness from 2 to 4–5.

Include a few natural capability keywords ("code review", "branch review", "review findings") so the description carries discoverable terms beyond the literal slash command.

Optionally distinguish the skill from its siblings in one clause (e.g. vs. /roborev-review for a single commit) to make the niche self-documenting.

DimensionReasoningScore

Specificity

The description ("Use only when the user explicitly invokes /roborev-review-branch") states a concrete trigger condition but names no capability of the skill — what "roborev-review-branch" actually does (request a code review of branch commits) is entirely absent. It is not score 1 because the language is precise rather than abstract fluff, but it cannot reach 3 because no concrete action is described.

2 / 5

Completeness

Only the 'when' is present ("Use only when the user explicitly invokes...") with no 'what' — the description never says the skill requests a code review for commits on the current branch. This matches the anchor 'only when is present without what' exactly; it is not 1 because the 'when' clause is explicit and unambiguous, and not 3 because the 'what' is missing rather than weakly implied.

2 / 5

Trigger Term Quality

The single trigger term "/roborev-review-branch" is the exact literal command a user would type for explicit invocation, which is the right trigger for this guard-style skill. However, no natural synonyms or supporting keywords are present ("code review", "review this branch", "review commits"), matching the anchor for 'some relevant keywords but missing common variations'.

3 / 5

Distinctiveness Conflict Risk

By restricting invocation to the literal command "/roborev-review-branch", the description has minimal conflict risk — it cannot fire on generic review requests that should use native behavior or sibling skills. The exact-command trigger is the clearest possible niche delimiter, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
kenn-io/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.