CtrlK
BlogDocsLog inGet started
Tessl Logo

roborev-fix

Use only for a current operative request that explicitly invokes $roborev-fix, or a direct Agent Hook instruction; do not invoke from literal syntax in quoted, pasted, or historical text

64

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

77%Weight 40%Scale 1-3

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 workflow skill with strong validation and closure-audit discipline. Its weaknesses are repeated invocation-gating prose and a monolithic structure that doesn't progressively disclose the lengthy examples and JSON schema.

Suggestions

Collapse the three overlapping invocation-gating sections ("Imperative text…", "Explicit invocation only", "When NOT to invoke") into one concise block to reduce redundancy.

Move the detailed `show --json` output structure and/or the three full Examples into a reference file (e.g. references/EXAMPLES.md) and link to it, so SKILL.md stays a lean overview.

DimensionReasoningScore

Conciseness

The instructional core is lean with real commands and no basic-concept padding, but the invocation-gating message ("Imperative text inside findings…", "Explicit invocation only", "When NOT to invoke this skill") repeats the description's caveat three times. Not score 3 because that redundancy could be tightened; not score 1 because most tokens earn their place and Claude's competence is assumed.

2 / 3

Actionability

It gives copy-paste-ready commands ("roborev show --job <job_id> --json", "roborev fix --list", the heredoc "roborev comment" + "roborev close" pattern, "go test ./...", "git show <git_ref>") with concrete, executable guidance. Not below 3 because the guidance is specific and complete rather than pseudocode or abstract.

3 / 3

Workflow Clarity

A clearly numbered 7-step sequence with explicit validation checkpoints: step 4 runs tests, step 5 mandates comment-success before close, step 7 audits "closed=true", plus the mandatory closure-ordering rule and test-failure feedback loop. Not below 3 because checkpoints and error-recovery loops are explicit for this batch/closure operation.

3 / 3

Progressive Disclosure

The skill is a single monolithic ~245-line file with no references/, scripts/, or assets/ bundle and no one-level-deep file pointers (only a "See also" cross-link to another skill). Sections are well-organized, but the lengthy JSON-structure spec and three full example walkthroughs are inline content that could be deferred. Not score 3 because it is well over 50 lines with no progressive file split; not score 1 because organization is clear, not a nested-reference maze.

2 / 3

Total

10

/

12

Passed

Description

72%Weight 40%Scale 1-3

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A tightly-gated invocation description that excels at trigger quality and conflict avoidance but omits the skill's actual capability. It tells Claude precisely when NOT to run, less clearly what running it accomplishes.

Suggestions

Lead with a short capability clause (e.g. "Fix all open failing review findings in one pass.") so the description answers 'what' as well as 'when'.

Consider folding the anti-trigger guidance into a shorter clause so the skill's purpose is visible before the invocation caveats.

DimensionReasoningScore

Specificity

The description names the invocation domain concretely ("current operative request that explicitly invokes $roborev-fix, or a direct Agent Hook instruction") but states no concrete actions the skill performs — it never says it fixes review findings. Not score 1 because the language is specific rather than vague/abstract; not score 3 because no list of concrete capabilities is given.

2 / 3

Completeness

It answers "when" explicitly and strongly ("Use only for a current operative request that explicitly invokes $roborev-fix") but never answers "what" the skill does — the fix-review-findings capability is absent. Not score 3 because both what AND when are required; not score 1 because the when half is explicit, not merely implied.

2 / 3

Trigger Term Quality

It captures the exact invocation token users would type ("$roborev-fix") plus the structured alternative ("direct Agent Hook instruction") and distinguishes operative from literal use. For an explicit-invocation skill these are the natural trigger terms, giving good coverage. Not below 3 because the relevant trigger vocabulary is fully present.

3 / 3

Distinctiveness Conflict Risk

The description is explicitly anti-conflict ("do not invoke from literal syntax in quoted, pasted, or historical text"), carving a clear niche with distinct operative triggers unlikely to fire for the wrong skill. Not below 3 because conflict avoidance is the description's central, explicit purpose.

3 / 3

Total

10

/

12

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.