CtrlK
BlogDocsLog inGet started
Tessl Logo

roborev-design-review-branch

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

51

Quality

56%

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-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 well-structured, actionable workflow with explicit validation and error-recovery guidance for running a branch design review. It is concise and clear, with only minor redundancy and placeholder notation keeping it from the top marks.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence without explaining known concepts, with only minor redundancy (the IMPORTANT boilerplate and the "Explicit invocation only" section partly restate trigger rules).

4 / 5

Actionability

It provides concrete executable commands (roborev review, git rev-parse --verify) with worked examples, but the heredoc <branch> placeholder and bracketed [--panel ...] notation leave minor gaps in copy-paste readiness.

4 / 5

Workflow Clarity

A clear 4-step sequence includes an explicit validation checkpoint (git rev-parse --verify, "Do not proceed" on failure) and error-recovery feedback loops (suggest roborev status/init/re-run); the review is read-only so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The single-file body is well-organized with clear section headers and a See-also list, with no content that needs splitting into bundle files; it exceeds 50 lines and lacks the one-level-deep references the 5 anchor calls for.

4 / 5

Total

17

/

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 functions as a precise gating trigger but fails to describe the skill's capabilities, answering only "when" and not "what." It is distinctive but not informative, which limits its usefulness for skill selection.

Suggestions

Add a concise statement of what the skill does, e.g. "Request a design review for all commits on the current branch and present the results."

Include natural-language trigger phrases users might say (e.g. "design review this branch") alongside the explicit invocation requirement.

Combine what and when in one sentence: describe the action first, then the invocation trigger.

DimensionReasoningScore

Specificity

The description states only a trigger condition ("Use only when the user explicitly invokes $roborev-design-review-branch") and names no concrete actions or capabilities, so it is entirely abstract about what the skill does.

1 / 5

Completeness

It gives an explicit "when" (explicit invocation of the command) but omits any "what" — the description never states what the skill does, matching the "only 'when' present without 'what'" anchor.

2 / 5

Trigger Term Quality

It provides the specific command invocation as the trigger but includes no natural-language phrases a user would actually say (e.g. "review this branch's design"), relying on technical jargon rather than natural keywords.

2 / 5

Distinctiveness Conflict Risk

The trigger is a single unambiguous explicit command invocation, making it highly distinct from other skills with minimal risk of triggering for the wrong skill.

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.