CtrlK
BlogDocsLog inGet started
Tessl Logo

roborev-review

Use only when the user explicitly invokes $roborev-review

52

Quality

65%

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/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 strong operational skill: concrete, executable commands with a real validation checkpoint, explicit error-recovery paths, and well-organized sections. Its main weaknesses are minor — the command-line syntax is repeated three times, and the Examples/Panels content is inlined rather than split into references.

DimensionReasoningScore

Conciseness

The body is operational throughout with no conceptual padding, but the "$roborev-review [commit] [--type security|design] [--panel <name>|none]" syntax is repeated three times (Usage, Instructions header, invocation line) and the IMPORTANT/guidelines meta-commentary could be trimmed. This fits anchor 4 ('minor instances of over-explanation that could be trimmed') rather than 3, since nothing explains concepts Claude already knows.

4 / 5

Actionability

Fully executable copy-paste commands are given for both cases ("roborev review --wait [...]" and the heredoc + "git rev-parse --verify --end-of-options \"$commit^{commit}\"" validation), with concrete error-recovery suggestions ("roborev status", "roborev init") and worked examples including job IDs. This matches the top anchor.

5 / 5

Workflow Clarity

Four clearly sequenced steps with an explicit validation checkpoint ("|| exit 1" ref check plus "Do not proceed") and error-path handling in step 3, matching anchor 4 ('clear sequence with most checkpoints present'). Not 5 because a validation failure simply aborts — there is no fix-and-retry feedback loop or checklist.

4 / 5

Progressive Disclosure

No bundle files exist and the ~130-line body is well organized under clear section headers with a 'See also' section for sibling skills, fitting anchor 4 ('good structure; most content is appropriately placed'). Not 5: the skill exceeds the under-50-line simple-skill exemption, and the Examples and Panels sections are inlined content that could live in reference files.

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 is a pure trigger guard: it prevents accidental invocation well but tells Claude nothing about what the skill actually does (request a code review and present results) or any natural trigger phrasing. Adding a capability clause like 'Requests a code review for a commit and presents verdicts and findings' alongside the explicit-invocation condition would lift specificity and completeness substantially.

Suggestions

Add a 'what' clause naming the concrete capabilities, e.g. 'Requests a code review for a commit via the roborev CLI and presents the verdict and findings, optionally fanning out to a panel of reviewers.'

Include natural trigger vocabulary (code review, review a commit, security review, design review) so the description conveys the domain even though invocation is explicit-only.

Keep the explicit-invocation restriction but combine it with the capability sentence in one description, e.g. 'Runs a roborev code review for a commit and presents the results. Use only when the user explicitly invokes $roborev-review.'

DimensionReasoningScore

Specificity

"Use only when the user explicitly invokes $roborev-review" states no concrete capability at all — it never says the skill runs a code review, presents verdicts, or handles commits/panels. This matches the 'Entirely vague; no concrete actions' anchor; it cannot be a 2 because unlike 'Processes PDF files' it does not name even a minimal action or domain.

1 / 5

Completeness

The 'when' is explicit ("only when the user explicitly invokes $roborev-review") but the 'what' is entirely missing — the description never says what the skill does. This fits anchor 2 ('only when is present without what') and cannot be 3, which requires a clear 'what'.

2 / 5

Trigger Term Quality

The only trigger token is the literal "$roborev-review" invocation; natural phrases users would actually say ("code review", "review this commit", "security review") are absent. It is above a 1 because the invocation token is explicit and meaningful, but it lacks any synonyms or natural-language variants.

2 / 5

Distinctiveness Conflict Risk

Restricting activation to explicit invocation ("Use only when the user explicitly invokes $roborev-review") creates a distinct niche with minimal conflict risk — the skill cannot fire on generic requests. This matches the top anchor exactly.

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.

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.