CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plannotator-inbox

Open the Plannotator Inbox in the browser (starting it if needed), tell the person its address, and learn how to use the Inbox for the rest of the session.

Quality

82%

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

92%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 model of operational writing for a small skill: copy-paste command, error-handling branch, precise messaging mechanics, and clear scope boundaries, with detail correctly deferred to --help output and a sibling skill. Only minor tightening of a couple of long sentences keeps conciseness from a perfect score.

DimensionReasoningScore

Conciseness

The body is dense and operational with no explanations of concepts Claude already knows — e.g. "Run the command yourself rather than telling the person to run it", "One thread per work stream, unless the person says otherwise". A few sentences could still be tightened (the long decision-handling bullet and "proactivity is better than procrastination" carry some redundancy), which places it at anchor 4 ('efficient; minor instances... that could be trimmed') rather than the every-token-earns-its-place level of anchor 5.

4 / 5

Actionability

Guidance is fully executable: a copy-paste command (```plannotator inbox --open```), a quoted failure mode with two remedies ("`Unknown inbox option: --open` means... update with `plannotator update`, or run `plannotator inbox`"), exact send mechanics ("`action` `send_message`, with a markdown `body`"), and pointers to `read_thread` and `plannotator inbox --help`. This matches anchor 5 ('fully executable; copy-paste ready commands; specific examples cover the common cases'), not anchor 4, which allows minor gaps the body does not have.

5 / 5

Workflow Clarity

The behavior is sequenced with an explicit error-recovery branch: run the command, tell the address in one sentence (with the remote-session variant), and "If it fails, tell them what it says" including interpretation of the specific error. For this simple single-purpose skill the single action is unambiguous, and the "After the address" section explicitly bounds what to do next, matching the simple-skill exception for a 5; no destructive or batch operations are involved so no validation cap applies.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files and no need for external references, yet is cleanly sectioned ("Using the Inbox", "After the address") and pushes detail outward appropriately — "Before your first send, run `plannotator inbox --help` and read it" and "The `plannotator` skill, where you have it, has more". Per the rubric's simple-skill guidance this earns a 5, and there are no buried or nested references that would lower it.

5 / 5

Total

19

/

20

Passed

Description

62%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 its concrete actions crisply and is highly distinctive thanks to the product-specific name, but it omits any 'when to use' trigger guidance and offers few natural trigger-term variations. Adding a 'Use when...' clause covering how a person asks for their inbox would raise completeness and trigger-term quality substantially.

Suggestions

Add an explicit trigger clause to the description, e.g. "Use when the person asks for their Plannotator Inbox, says they closed its tab, or wants you to send them messages or files through it."

Include natural user phrasings as trigger terms (e.g., 'inbox tab', 'where is my inbox', 'open the inbox') so the description matches how a person would actually ask.

Make the third action concrete — replace "learn how to use the Inbox for the rest of the session" with what that usage involves (leaving messages, :::question blocks, and files).

DimensionReasoningScore

Specificity

The description enumerates several concrete actions — "Open the Plannotator Inbox in the browser", "starting it if needed", "tell the person its address", "learn how to use the Inbox" — with only minor vagueness in the last action. It matches the 'lists several specific actions; minor gaps' anchor rather than 5, where "learn how to use the Inbox" is less concrete than the fully comprehensive multi-action example, and it is clearly above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

The 'what' is clear (open the Inbox, report its address, learn its use), but the description contains no 'Use when...' clause or equivalent trigger guidance — that omission appears only in the body, not the frontmatter. Per the judging guidelines a missing 'Use when...' clause caps completeness at 3, and anchor 3 ('clear what but when is missing') is the exact fit; it is not a 4 because 'when' is absent rather than merely imprecise.

3 / 5

Trigger Term Quality

The core natural keywords are present ("Plannotator Inbox", "browser", "address"), which map to what a person would say, but there are no variations or synonyms (e.g., 'tab', 'window', 'where is it', 'show me'). This fits anchor 3 ('some relevant keywords but missing common variations or synonyms') better than anchor 4, whose example shows a broader spread of natural trigger terms.

3 / 5

Distinctiveness Conflict Risk

"Plannotator Inbox" is a unique product-scoped name repeated twice, giving a clear niche with minimal conflict risk against generic skills. It matches anchor 5 ('clear niche with distinct triggers; minimal conflict risk') and is not anchor 4, which reserves overlap risk with closely related skills that this name does not carry.

5 / 5

Total

15

/

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/skills/core/plannotator-inbox/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.