CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-bugbot

Review code changes with Bugbot subagent.

Quality

75%

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 ./.cursor/skills-cursor/review-bugbot/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.

The body is a strong operational skill: it gives exact, executable instructions for both the in-place and subagent paths, handles the PR-checkout and failure cases with explicit checkpoints and bounded retries, and specifies output formats precisely. Its only weaknesses are minor — some duplicated instructions and no section headers for easier scanning. No bundle files exist, and none are needed at this scope.

DimensionReasoningScore

Conciseness

The body is dense with operational specifics and explains nothing Claude already knows, but the output-table spec ("compact markdown table ... Severity, Location (file:line), Finding") is stated nearly verbatim twice and the in-place gating conditions are repeated at the end. These are minor trim opportunities, fitting the efficient-with-minor-overexplanation anchor rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Guidance is fully executable: exact launch parameters ("run_in_background: false", "description: \"Bugbot\"", "subagent_type: \"bugbot\""), a copy-paste-ready prompt-shape template with per-field inclusion rules, a concrete Change Description example, and exact output columns and phrasings. This matches the copy-paste-ready anchor with common cases covered.

5 / 5

Workflow Clarity

The sequence is explicit with validation checkpoints and feedback loops: a clear in-place vs subagent decision tree, the PR special case checks checkout state and asks the user before stashing, and failure handling classifies errors with retry-once rules, a natural-language fallback as last resort, and an explicit stop condition. This matches the explicit-validation-with-error-recovery anchor.

5 / 5

Progressive Disclosure

There are no bundle files and everything is appropriately inline for a single-task orchestration skill, with clear paragraph/list organization and no buried references. It falls short of anchor 5 because there are no section headers to aid navigation across ~80 lines and the nested Change Description example sits at an awkward indentation, which are minor organization gaps fitting anchor 4.

4 / 5

Total

18

/

20

Passed

Description

50%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 concise and identifies a concrete action and mechanism, but it has no trigger guidance and misses the natural synonyms (diff, bugs, PR) users would say when needing this skill. All dimensions land at the mid anchor: serviceable, but well short of the good examples. It reads as a bare capability statement rather than a discoverability surface.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to run /review-bugbot, review a diff or branch changes, or find bugs in recent code changes."

Include the natural synonyms users actually say — diff, bugs, findings, pull request — so trigger matching works on real phrasing, not just "review code changes".

State the output briefly (e.g. "...returning severity-sorted findings in a compact table") to sharpen the what and distinguish it from generic review skills.

DimensionReasoningScore

Specificity

"Review code changes with Bugbot subagent" names the domain (code changes) and one concrete action (review) plus its mechanism (Bugbot subagent), matching the 1-2-concrete-actions anchor. It is not a 4 because only a single action is listed with no coverage of what the review covers or produces.

3 / 5

Completeness

The "what" is clear (review code changes via a Bugbot subagent), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the "what" is specific rather than vague.

3 / 5

Trigger Term Quality

"Review", "code changes", and "Bugbot" are natural terms, but the description omits common variations users would actually say such as "diff", "bugs", "findings", or "PR". This is some relevant keyword coverage with missing synonyms, not the good coverage of a 4.

3 / 5

Distinctiveness Conflict Risk

"Review code changes" is a generic phrase that overlaps with any general code-review skill, though the named "Bugbot subagent" gives it a partial niche. It could still be triggered in place of similar review skills, fitting anchor 3 rather than the minor-overlap-risk anchor 4.

3 / 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

saski/arnesto

Path

.cursor/skills-cursor/review-bugbot/SKILL.md

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.