CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plannotator-annotate

Open Plannotator's annotation UI for a markdown file, plain-text config file (.yaml, .json, .toml, .ini, .csv, .log, …), HTML file, URL, or folder and then respond to the returned annotations.

Quality

84%

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 body is an exemplar of a simple operational skill: exact commands for both usage modes, harness-specific execution guidance, explicit handling of every possible session outcome with an error-recovery loop, and zero padding. All four dimensions land at the top anchor, with the simple-skill exceptions for workflow clarity and progressive disclosure both satisfied.

DimensionReasoningScore

Conciseness

Every line carries non-obvious operational content — exact commands, background-execution rationale ('a foreground run would be stopped and the annotations lost'), and tool-specific approval semantics — with no padding or explanation of concepts Claude already knows; the few justification clauses (e.g. the 2-minute foreground limit) each prevent a real failure mode rather than over-explain, which keeps it above anchor 4.

5 / 5

Actionability

Provides copy-paste-ready commands for both modes ('plannotator annotate <path-or-url>' and 'plannotator annotate <path-or-url> --gate --json') plus concrete execution details ('is_background: true, and no trailing &', 'end your turn without stopping the task') and specific result fields ('"decision": "dismissed"', '"decision": "approved" with a "feedback" field'), fully matching the executable anchor 5.

5 / 5

Workflow Clarity

The sequence — run in background, end turn, read the output file when the task finishes, then act — is unambiguous, and the numbered behavior list enumerates outcome checkpoints including an explicit error-recovery loop ('work out which target the user means and re-run the command yourself'); as a simple single-purpose skill with clear outcome validation, it merits the top anchor.

5 / 5

Progressive Disclosure

The ~30-line body is well organized into command modes, execution notes, and a numbered behavior list, with no content that belongs in separate files and no bundle files present to reference; per the under-50-line simple-skill guideline, well-organized sections alone merit the top anchor.

5 / 5

Total

20

/

20

Passed

Description

61%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 concrete and tool-specific, with strong enumeration of supported input types and file extensions, but it omits any 'use when' trigger guidance and does not mention the --gate review/approval capability. This limits completeness and natural trigger coverage even though the stated actions themselves are clear. Overall it sits noticeably above the vague-baseline descriptions but below the exemplar trigger-complete ones.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to annotate or review a document in Plannotator, or asks for feedback on a plan, spec, or config file instead of reviewing it inline in chat.'

Mention the gate capability in the description, e.g. 'optionally gate generated plans/specs for approval with --gate', so the review/approval use case is discoverable from the description alone.

Include natural trigger synonyms users would actually say — 'review', 'feedback', 'approve', 'gate' — alongside the existing file-extension list to round out trigger term coverage.

DimensionReasoningScore

Specificity

Names the domain ('Plannotator's annotation UI') and exactly two concrete actions — 'Open... annotation UI' and 'respond to the returned annotations' — matching the 1-2-actions anchor; coverage is not comprehensive because the --gate approval mode, a major capability of the skill, is absent (the anchor-4 example lists three actions with only minor gaps).

3 / 5

Completeness

The 'what' is clear ('Open Plannotator's annotation UI... and then respond to the returned annotations') but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines; it scores above anchor 2 because the 'what' is concrete rather than vague.

3 / 5

Trigger Term Quality

Good keyword coverage including file extensions ('.yaml, .json, .toml, .ini, .csv, .log') plus 'markdown', 'HTML', 'URL', and 'folder', but a few natural terms users would actually say — 'review', 'feedback', 'approve', 'gate' — are missing, fitting anchor 4 rather than the comprehensive-synonyms-and-extensions anchor 5.

4 / 5

Distinctiveness Conflict Risk

The named tool 'Plannotator' gives a clear niche with distinct triggers, but generic 'annotate' phrasing over broad targets ('URL, or folder') leaves minor overlap risk with generic annotation/review skills, and the anchor-5 example's explicit trigger boundary ('Use when working with PDF files...') is absent here.

4 / 5

Total

14

/

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/qwen-code/skills/plannotator-annotate/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.