CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

68

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

93%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 tight, actionable runbook with concrete commands and outcome handling. It loses only a point on workflow clarity for slightly implicit verification checkpoints.

DimensionReasoningScore

Conciseness

Lean and efficient with no concept over-explanation; every line instructs an action and it assumes Claude's competence, matching the 5 anchor.

5 / 5

Actionability

Provides a concrete executable command (plannotator annotate <path-or-url>) with copy-ready handling for returned annotations, approved-with-notes, and unresolvable-argument recovery, covering the common and edge cases.

5 / 5

Workflow Clarity

Clear numbered sequence with error-recovery feedback (re-run with a concrete path when args cannot be resolved), but the wait/verification checkpoints are slightly implicit rather than explicit validation steps.

4 / 5

Progressive Disclosure

Under 50 lines, single purpose, no external references or bundle files, and well-organized into a heading, command block, and numbered list — qualifying for 5 under the simple-skill exception.

5 / 5

Total

19

/

20

Passed

Description

70%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 clearly conveys what the skill does and enumerates target types thoroughly, but lacks an explicit "Use when..." trigger clause, which caps completeness. Trigger coverage is strong but misses the plain verb users would naturally say.

Suggestions

Add an explicit "Use when..." clause (e.g., "Use when the user wants to annotate a document in Plnotator rather than review it inline") to lift completeness above 3.

Surface the natural verb "annotate" / "annotation" as a trigger term directly in the description so users' phrasing matches.

DimensionReasoningScore

Specificity

Names two concrete actions ("Open Plannotator's annotation UI", "respond to the returned annotations") alongside a comprehensive enumeration of target types, fitting above the 3 anchor but short of the multiple-action 5 anchor.

4 / 5

Completeness

The "what" is explicit, but there is no "Use when..." clause or equivalent explicit trigger guidance in the description, so the "when" is only weakly implied — capping completeness at 3 per the judging guideline.

3 / 5

Trigger Term Quality

Strong keyword coverage across file types and extensions (.yaml, .json, .toml, .ini, .csv, .log, HTML, URL, folder), but it omits the most natural user phrasing ("annotate") that appears only in the body.

4 / 5

Distinctiveness Conflict Risk

Tied to a named tool (Plannotator) with a specific UI and command, giving it a clear niche with distinct triggers and minimal conflict risk with other skills.

5 / 5

Total

16

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
backnotprop/plannotator
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.