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 an exemplary lean, executable skill body: concrete commands with a real example for each invocation variant, precise operational rules, and an explicit guard against starting work when the session closes without feedback. Nothing is padded, outdated, or misplaced for a skill of this size.

DimensionReasoningScore

Conciseness

The body is ~25 lean lines where every token is non-obvious operational detail (run command, path rules, quoting, base/diff-mode semantics, closed-session handling) with zero padding or explanation of concepts Claude already knows. Matches the anchor 'Lean and efficient; assumes Claude's competence; every token earns its place' — not the score-4 anchor since there are no over-explanation instances to trim.

5 / 5

Actionability

Commands are fully executable and copy-paste ready ('PLANNOTATOR_ORIGIN=kiro-cli plannotator review', with a PR URL, with '../feature-worktree', with --base/--diff-type), covering the common cases with a concrete example path. Matches the anchor 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases' rather than 4, which reserves room for minor gaps like unspecified valid --diff-type values.

5 / 5

Workflow Clarity

This is a simple single-task skill whose one action (run the review, then address returned feedback) is unambiguous, and it includes an explicit conditional checkpoint for the no-feedback case ('Do not begin any work: closing the session is not approval') with the exact expected output string. The simple-skill exception applies and no destructive/batch cap is triggered, so it exceeds the score-4 anchor's 'minor validation gaps'.

5 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references, and is well organized in a logical flow (basic run, target variations, base/diff options, edge case), so the under-50-lines guideline yields a 5. No bundle files exist to reference, and the score-4 anchor's 'minor organization gaps' do not apply.

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 is concise, third-person, and product-anchored with a clear statement of what the skill does, but it omits any 'Use when...' trigger guidance and lacks natural trigger phrase coverage. It is serviceable for a user-invoked skill but below the rubric's standard for a complete, well-triggered description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to run a Plannotator review, review changes in Plannotator, or address Plannotator review feedback.'

Include natural trigger phrases and synonyms users would actually say — 'code review', 'review my changes', 'PR review', 'Plannotator' — to improve keyword coverage.

Slightly expand the 'what' with concrete outcomes, e.g. 'collect the returned comments and apply the requested fixes in the named directories,' for more comprehensive capability coverage.

DimensionReasoningScore

Specificity

It names the domain ('Plannotator's browser-based code review UI') and two actions ('Open... UI and address the returned feedback'), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because 'address the returned feedback' is generic and no further specific capabilities are listed.

3 / 5

Completeness

The 'what' is clear (open the review UI, address returned feedback), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. This exactly matches the anchor 'Has a clear what but when is missing or only weakly implied' and is below 4, which requires both what and when.

3 / 5

Trigger Term Quality

'code review' is a relevant natural keyword anchored by the product name 'Plannotator', but common variations and synonyms users would say (review my changes, PR review, review feedback, code review session) are missing. Fits the anchor 'Some relevant keywords but missing common variations or synonyms' rather than 4's 'Good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The product-specific name 'Plannotator' establishes a clear niche, but the generic 'code review' action carries minor overlap risk with closely related review skills, fitting the anchor 'Mostly distinct; minor overlap risk with closely related skills'. It is above 3 because the product anchor makes mis-triggering for unrelated skills unlikely, but short of 5's distinct comprehensive triggers.

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/kiro-cli/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.