CtrlK
BlogDocsLog inGet started
Tessl Logo

roborev-design-review

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

54

Quality

68%

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/claude/roborev-design-review/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.

A strong, executable workflow skill: concrete commands, a well-sequenced five-step process with validation and error-recovery checkpoints, and clear presentation/next-step guidance including the panel-synthesis case. Its main weakness is token efficiency — the command template is duplicated verbatim and the Examples section re-narrates the steps — which costs tokens without adding clarity.

DimensionReasoningScore

Conciseness

Mostly efficient — no padding explaining concepts Claude already knows — but the full heredoc command block is repeated verbatim in §2 and §3, and the Examples section restates the numbered steps nearly word-for-word. This matches anchor 3 ('mostly efficient but could be tightened'): it is not 2 because there is no unnecessary conceptual explanation, and not 4 because the duplicated blocks are a clear trim candidate (§3 could reference 'the command from step 2').

3 / 5

Actionability

Fully copy-paste-ready commands: the heredoc + 'git rev-parse --verify --end-of-options "$commit^{commit}" || exit 1' validation snippet, 'roborev review "$commit" --wait --type design [--panel <name>|none]', concrete error-recovery suggestions ('roborev status', 'roborev init'), and the exact job-id extraction source ('Enqueued job <id> for ...' line). Both common cases (commit omitted vs specified, panel vs none) are covered with specific handling, matching anchor 5.

5 / 5

Workflow Clarity

Five clearly sequenced steps (validate inputs → build command → background run → present results → offer next steps) with an explicit validation gate ('If validation fails, inform the user the ref is invalid. Do not proceed.') and error-recovery guidance for daemon/repo failures in step 4. The operation is non-destructive so the destructive-cap does not apply, and the validation + recovery structure matches the anchor 5 example.

5 / 5

Progressive Disclosure

No bundle files exist and the single SKILL.md is well-sectioned (Usage, Instructions with numbered subsections, Examples, Panels, See also) with no nested references and easy navigation — appropriate for a single-purpose workflow skill. It is not 5 because at ~157 lines the body carries duplicated command blocks and a fairly detailed Panels subsection plus an Examples section that together push past a lean overview, creating minor organization gaps rather than a cleanly minimal core.

4 / 5

Total

17

/

20

Passed

Description

40%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 an invocation gate — unambiguous about when to fire and unlikely to conflict — but it says nothing about what the skill actually does. As a capability description it is incomplete and low-specificity; the skill's purpose is only discoverable by opening the body.

Suggestions

Add a 'what' clause before the trigger clause, e.g. 'Runs a roborev design review of the current HEAD or a specified commit and presents the verdict and severity-grouped findings.'

Include natural trigger terms users would actually say alongside the command name, such as 'design review', 'review this commit', 'commit design feedback', and 'roborev'.

State the key parameters/capabilities (commit ref optional, --panel multi-reviewer option, background execution with results presented on completion) so the description covers the skill comprehensively.

DimensionReasoningScore

Specificity

The description 'Use only when the user explicitly invokes /roborev-design-review' names the design-review domain only via the command token and states no concrete actions or capabilities whatsoever. It sits between anchor 1 (pure abstraction like 'Helps with documents') and anchor 2 ('Names the domain but actions are minimal or generic') — the domain is identifiable, but there is no action statement at all, so it cannot reach 3, which requires 1-2 named concrete actions.

2 / 5

Completeness

Only the 'when' is present, and it is explicit ('Use only when the user explicitly invokes /roborev-design-review'), while the 'what' — that the skill runs a roborev design review of a commit and presents verdict and findings — is entirely missing from the description. This is exactly anchor 2 ('only when is present without what', e.g. 'Use when working with documents'); it cannot be 3 because a clear 'what' is required, and cannot be 1 because the 'when' is fully explicit.

2 / 5

Trigger Term Quality

The only trigger term is the literal '/roborev-design-review'; natural phrases a user would say when needing this skill — 'design review', 'review this commit', 'roborev' — are absent. This matches anchor 3 ('some relevant keywords but missing common variations or synonyms'): there is a relevant keyword, but coverage of natural language variants is missing.

3 / 5

Distinctiveness Conflict Risk

Gating on the literal command makes accidental triggering for the wrong skill very unlikely — a clear, distinct trigger. It does not reach 5 because sibling skills named in the body ('/roborev-review --type design', '/roborev-design-review-branch', '/roborev-fix') occupy adjacent command space and the description itself does not articulate the niche, leaving minor overlap risk.

4 / 5

Total

11

/

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.