CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plannotator-review

Open Plannotator's browser-based code review UI and address the returned feedback.

64

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%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 content is a model of lean, executable skill authoring: complete commands for the common invocation forms, precise rules for path handling and feedback interpretation, and an explicit guard against misreading a closed session as approval. Nothing is padded, nothing is missing for this skill's scope.

DimensionReasoningScore

Conciseness

Every line earns its place: the run command, argument forms, path/quoting rules, feedback semantics, and the no-feedback guard. There is no padding and no explanation of concepts Claude already knows. Re-reading anchor 4, there are no over-explanations to trim, so it fits the top anchor.

5 / 5

Actionability

Fully executable copy-paste commands covering the common cases (no argument, PR URL, directory path), with concrete follow-up detail ('Feedback names the directory where changes belong') and the exact expected output string ('Review session closed without feedback.') for edge-case detection. This matches the anchor-5 example structure of complete commands plus a concrete follow-up note.

5 / 5

Workflow Clarity

This is a simple single-action skill under 50 lines whose action is unambiguous: run the review, then act on the output. The no-feedback branch is an explicit checkpoint ('acknowledge it in one sentence and stop. Do not begin any work'), and no destructive or batch operations exist that would require further validation. Not anchor 4 because no checkpoint is missing.

5 / 5

Progressive Disclosure

The body is under 50 lines, has no need for external references (no references/scripts/assets exist), and is well-organized with a single heading and logically ordered sections. Per the rubric's simple-skill guideline, this earns the top score with no inline content that belongs in separate files.

5 / 5

Total

20

/

20

Passed

Description

53%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 states a concrete, tool-specific capability without padding, but omits any "when to use" trigger guidance and describes the follow-up action ("address the returned feedback") only generically. It is clearly distinct from most skills thanks to the Plannotator brand, though it shares common vocabulary with general code-review skills.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the user asks for a Plannotator review or wants to run code review through the Mistral Vibe UI.'

Make 'address the returned feedback' concrete — e.g. 'triage the returned findings, apply fixes in the directory each item names, and respond to each feedback item'.

Include natural trigger phrases users would actually say, such as 'code review', 'review feedback', or 'Plannotator review'.

DimensionReasoningScore

Specificity

Names the domain ("Plannotator's browser-based code review UI") and two actions ("Open" the UI, "address the returned feedback"), but "address the returned feedback" is generic, so coverage is not comprehensive. It is above anchor 2 because the primary action is concrete, but below anchor 4 because the second action lacks specific detail.

3 / 5

Completeness

Has a clear "what" (open the review UI and address feedback) but no "when" clause at all — neither explicit nor implied — which caps completeness at 3 per the judging guidelines. Not anchor 2 because the "what" is concrete, not vague; not anchor 4 because "when" is entirely absent rather than under-specified.

3 / 5

Trigger Term Quality

Contains some relevant natural keywords ("Plannotator", "code review", "feedback") but misses common variations and synonyms users would say, such as "review my code", "PR review", or "review findings". Not anchor 2 because the terms present are not purely generic; not anchor 4 because coverage of natural phrasings is thin.

3 / 5

Distinctiveness Conflict Risk

The proper noun "Plannotator" carves a distinct niche, but "code review" and "feedback" broadly overlap generic code-review skills, creating minor conflict risk with closely related skills. Not anchor 5 because the common terms could plausibly collide with general review skills; not anchor 3 because the named tool makes it clearly distinguishable.

4 / 5

Total

13

/

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

backnotprop/plannotator

Path

apps/vibe/skills/plannotator-review/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.