CtrlK
BlogDocsLog inGet started
Tessl Logo

roborev-design-review-branch

Use only when the user explicitly invokes $roborev-design-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/codex/roborev-design-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.

A highly actionable, well-sequenced operational skill: exact commands with validation and error-recovery paths, clear result-presentation rules including the panel synthesis subtlety, and lean prose. The only structural weakness is that everything lives inline in a ~135-line body with no reference split, and a few spots (Examples, post-snippet bullets) restate earlier content.

DimensionReasoningScore

Conciseness

The body is lean and task-specific — no concept explanations Claude already knows, and dense operational detail ("roborev review --branch --wait --type design [--panel <name>|none]", "The `--wait` flag blocks until the review completes"). Minor trimmable redundancy keeps it below anchor 5: the bullets after the command snippets re-explain --base/--panel already shown in the snippets, the Examples section restates steps 2–4, and the "These instructions are guidelines, not a rigid script" boilerplate adds little.

4 / 5

Actionability

Commands are copy-paste ready and complete, including the heredoc + `git rev-parse --verify --end-of-options` validation snippet, exact flag semantics (--panel fans out, --panel none forces single-agent), and concrete recovery suggestions ("roborev status", "roborev init"). This matches anchor 5: fully executable guidance with specific examples covering both the default and --base cases.

5 / 5

Workflow Clarity

The four-step sequence (validate inputs → build and run → present results → offer next steps) has an explicit validation checkpoint ("git rev-parse ... || exit 1", "If validation fails ... Do not proceed") and error-recovery feedback loops (report errors, suggest roborev status/init/re-run), matching anchor 5. The destructive/batch cap does not apply — this is a read-only review, and the panel-synthesis rule ("offer fix on that parent id — never an individual reviewer") adds a further correctness checkpoint.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and all sections are well-organized with clear headers, so navigation is easy — but the file runs ~135 lines with no external references, and detail like the Panels subsection and Sandbox access section is inline where a split (or trimming) would serve the token budget. This fits anchor 4 ('good structure; most content appropriately placed; minor organization gaps') rather than anchor 5, which presumes appropriately split content and one-level-deep references.

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 is a deliberate explicit-invocation gate: excellent distinctiveness and unambiguous 'when' guidance, but it omits the 'what' entirely and lists zero concrete capabilities, leaving a reader who sees only the frontmatter with no idea what invoking it will do.

Suggestions

Add a one-clause 'what' statement, e.g. "Requests a roborev design review of all commits on the current branch and presents the synthesized verdict and findings." before the 'Use only when...' clause.

Mention the key options inline (--base <branch>, --panel <name>|none) so the description covers the skill's actual capability surface, not just its trigger.

Optionally note the companion fix flow ("run $roborev-fix <job_id> on findings") so the description conveys the skill's full scope without lengthening it much.

DimensionReasoningScore

Specificity

The description "Use only when the user explicitly invokes $roborev-design-review-branch" states no capability actions at all — nothing like 'request a design review of all commits on the branch and present the verdict and findings' appears. It only edges above anchor 1 because the token itself names the domain (design review, branch); it does not list even one concrete action, so anchor 3 ('names domain and 1-2 concrete actions') is out of reach.

2 / 5

Completeness

Only the 'when' half is present, and it is maximally explicit ("Use only when the user explicitly invokes..."), but the 'what' — what the skill actually does (run a design review of the branch and present results) — is entirely absent. This matches anchor 2 ('only when is present without what') and falls short of anchor 3, which requires a clear 'what'.

2 / 5

Trigger Term Quality

Relevant keywords exist but only inside the literal token and the phrase "explicitly invokes" — e.g. "design review", "branch", "roborev". Natural trigger phrases a user would say ("review this branch's design", "design review of my commits") are deliberately omitted, which fits anchor 3 ('some relevant keywords but missing common variations or synonyms'); it is not anchor 4 because no prose-level natural terms are given, and not anchor 2 because the token does carry the key terms.

3 / 5

Distinctiveness Conflict Risk

The explicit-invocation-only trigger ("Use only when the user explicitly invokes $roborev-design-review-branch") makes accidental triggering essentially impossible — a clear niche with distinct triggers and minimal conflict risk, exactly anchor 5, and clearly better than anchor 4's 'minor overlap risk'.

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.