CtrlK
BlogDocsLog inGet started
Tessl Logo

roborev-design-review

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

49

Quality

53%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./internal/skills/codex/roborev-design-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 well-structured, mostly executable runbook with explicit input validation and error-handling guidance, plus genuinely non-obvious operational detail (sandbox escalation, panel synthesis semantics). It is concise and earns most of its tokens.

DimensionReasoningScore

Conciseness

The body is lean and avoids explaining concepts Claude already knows; the only redundancy is the Examples section restating commands already shown in Instructions, a minor trim opportunity rather than padding.

4 / 5

Actionability

It provides concrete executable commands (roborev review --wait --type design, the heredoc+git rev-parse snippet, roborev status/init) covering the common cases, with only the placeholder substitutions (<commit>, [--panel <name>|none]) keeping it from being fully copy-paste ready.

4 / 5

Workflow Clarity

A clear 4-step sequence with an explicit validation gate (git rev-parse, 'do not proceed' on failure) and an error-recovery branch in step 3; the recovery is suggest-based rather than a tight fix-and-retry loop, a minor gap.

4 / 5

Progressive Disclosure

Well-organized into clear sections (Usage, Sandbox access, When NOT to invoke, Instructions, Examples, See also) with one-line cross-skill pointers; no bundle files exist, and the inline Panels/Sandbox content is reasonably placed for a skill of this size.

4 / 5

Total

16

/

20

Passed

Description

31%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 highly distinctive and unambiguous about its trigger, but it omits any statement of what the skill does, relying entirely on the command name for context. It reads as a guard clause rather than a capability description.

Suggestions

Add a 'what' clause stating concrete actions, e.g. 'Request a design review for a commit and present the verdict and findings. Use only when the user explicitly invokes $roborev-design-review.'

Surface a natural phrase such as 'design review' or 'review a commit's design' so the capability is legible beyond the command token, even though invocation remains explicit.

Prefer third-person declarative voice ('Requests a design review...') over the imperative 'Use only when...' to lift the specificity above the floor.

DimensionReasoningScore

Specificity

The description 'Use only when the user explicitly invokes $roborev-design-review' names no concrete actions or domain at all — it states only when to trigger, with zero 'what does this do' content, matching the 'entirely vague; no concrete actions' anchor.

1 / 5

Completeness

It clearly answers 'when' (explicit invocation) but provides no 'what' — the skill's purpose (request a design review, present verdict/findings) is absent, matching the 'only when is present without what' anchor.

2 / 5

Trigger Term Quality

The only natural keyword is 'design review' embedded inside the command name; the surrounding phrasing ('explicitly invokes', '$roborev-design-review') is mechanical rather than the natural phrases users say, so it sits just below the midpoint.

2 / 5

Distinctiveness Conflict Risk

Requiring literal explicit invocation of a specific command makes accidental triggering essentially impossible — a clear niche with minimal conflict risk.

5 / 5

Total

10

/

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.