CtrlK
BlogDocsLog inGet started
Tessl Logo

roborev-review-branch

Request a code review for all commits on the current branch and present the results

64

Quality

55%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./internal/skills/claude/roborev-review-branch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 conveys a clear but narrow action (requesting code review for branch commits) without providing explicit trigger guidance or a 'Use when...' clause. It lacks breadth in trigger terms and doesn't enumerate the specific capabilities or outputs of the review process, making it harder for Claude to confidently select this skill from a large pool.

Suggestions

Add an explicit 'Use when...' clause with trigger phrases like 'review my code', 'check my commits', 'PR review', 'review changes on this branch'.

Expand the capability description to list specific actions such as 'analyzes diffs, identifies issues, suggests improvements, summarizes review findings'.

Include common keyword variations users might say: 'code review', 'PR', 'pull request', 'review my branch', 'check my changes'.

DimensionReasoningScore

Specificity

Names the domain (code review) and describes a specific workflow (request review for commits on current branch, present results), but doesn't list multiple concrete actions beyond that single flow.

2 / 3

Completeness

Describes what it does (request code review for commits and present results) but has no explicit 'Use when...' clause or trigger guidance, which per the rubric should cap completeness at 2, and the 'what' is also fairly thin, placing this at 1.

1 / 3

Trigger Term Quality

Includes natural terms like 'code review', 'commits', and 'current branch' which users might say, but misses common variations like 'PR review', 'pull request', 'review my changes', 'diff review', or 'git branch'.

2 / 3

Distinctiveness Conflict Risk

The combination of 'code review' + 'commits on current branch' is somewhat specific, but could overlap with general code review skills, git diff analysis skills, or PR-related skills without clearer scoping.

2 / 3

Total

7

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured, actionable skill with a clear multi-step workflow, proper validation checkpoints, and good error handling guidance. Its main weakness is moderate verbosity — the examples section largely restates the instructions, and some framing sections add overhead without proportional value. Overall it's a solid, functional skill that could be tightened.

Suggestions

Remove or significantly condense the Examples section, as it mostly restates the workflow steps already described — a single brief example would suffice.

Consider merging the 'When NOT to invoke' and 'IMPORTANT' sections into a single brief preamble to reduce overhead.

DimensionReasoningScore

Conciseness

The skill is mostly efficient but has some redundancy — the examples section largely restates the instructions already given in steps 1-5, and some phrasing could be tightened (e.g., the 'When NOT to invoke' and 'IMPORTANT' sections add moderate overhead). However, it doesn't explain concepts Claude already knows.

2 / 3

Actionability

Provides concrete, executable bash commands and specific tool invocations (Task tool with run_in_background and subagent_type). Each step has clear, copy-paste-ready commands with exact flags and parameters.

3 / 3

Workflow Clarity

The 5-step workflow is clearly sequenced with explicit validation (step 1 validates the git ref before proceeding), error handling guidance (step 4 covers error cases), and conditional branching (step 5 offers different next steps based on pass/fail). The feedback loop for errors is well-defined.

3 / 3

Progressive Disclosure

The 'See also' section provides good cross-references to related skills. However, the examples section is inline and largely duplicates the instructions, making the document longer than necessary. The content could benefit from being more concise inline rather than needing separate files, but the examples add bulk without much new information.

2 / 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.

Validation11 / 11 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.