CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mailbox

Load to send, read or resolve repository mailbox messages and owner questions.

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/mailbox/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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.

An exceptionally lean body with verified, correctly-deferred bundle references and no wasted tokens. Its weaknesses are operational: no example invocation and no visible message-flow sequence, leaving the reader one `--help` indirection away from executable guidance.

Suggestions

Include one copy-paste-ready example invocation, e.g. `scripts/lane-mail ask --item NAME --file PATH` then `scripts/lane-mail wait --item NAME --id MSGID`, so the entry point is executable without reading `--help` first.

Add a minimal 3-step core flow (ask → wait for answer → resolve) so the primary workflow is visible in the body rather than implied by the capability matrix.

DimensionReasoningScore

Conciseness

The body (~15 lines) is lean with zero padding: every sentence carries information — the tool pointer ("Use `scripts/lane-mail` to send, read and resolve repository messages"), the capability matrix, refusal behavior, sibling-skill usage, dependencies, and writer internals. Nothing explains concepts Claude already knows, matching "every token earns its place".

5 / 5

Actionability

"Use `scripts/lane-mail`" and "Its `--help` defines verbs, envelopes, receipts and refusal keys" give a real, executable entry point, but no example invocation (e.g. an ask/wait/resolve command line) appears in the body — key operational details are only reachable one indirection away. This fits "Some concrete guidance but incomplete... missing key details" rather than the mostly-executable level of 4.

3 / 5

Workflow Clarity

The body describes capability dependencies and refusal behavior ("A directive to an overseer needs the reader that orch records... These operations refuse before writing") rather than an operational sequence; there is no ask→wait→resolve procedure and no validation checkpoints. The simple-skill exception does not lift it to 5 because the single action is not unambiguous without reading `--help`; it is not 2 because the content that is present is coherent and informative.

3 / 5

Progressive Disclosure

The skill is under 50 lines and needs no external reference docs; all referenced bundle paths (scripts/lane-mail, scripts/lib/file-lock.sh, scripts/lib/mailbox-append.sh) are verified real files, references are one level deep and clearly signaled, and bulk protocol detail is correctly deferred to the tool's own `--help`. Per the rubric's simple-skill guideline this matches the well-organized top anchor.

5 / 5

Total

16

/

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 communicates a niche domain with a clear "what" but no "when" — there is no "Use when..." clause or trigger guidance, so completeness is capped. Trigger term coverage is thin, omitting the natural synonyms (asks, notices, answers, directives) that the skill body itself uses.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user mentions repository mailbox messages, owner questions, asks, notices, answers, or directives."

Include the natural synonyms already present in the skill body (asks, notices, answers, directives, receipts) so trigger term coverage includes common variations.

Make the capabilities slightly more concrete, e.g. "send, read, wait for and resolve repository mailbox messages (asks, notices) and owner questions", so more of the actual verb surface is named.

DimensionReasoningScore

Specificity

"send, read or resolve repository mailbox messages and owner questions" names the domain and three verbs, but the objects stay abstract and coverage is incomplete (no notices, directives, receipts, compaction). It matches "Names domain and 1-2 concrete actions, but not comprehensive" rather than the several-specific-actions level of 4.

3 / 5

Completeness

The "what" is present ("send, read or resolve repository mailbox messages and owner questions") but the "when" is entirely absent — no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the rubric guidelines. Not 4 because the when-clause is not even weakly present.

3 / 5

Trigger Term Quality

"mailbox messages" and "owner questions" are relevant keywords, but common variations the skill body itself uses (asks, notices, answers, directives, receipts) are missing. This fits "Some relevant keywords but missing common variations or synonyms" rather than the good-coverage level of 4.

3 / 5

Distinctiveness Conflict Risk

"repository mailbox messages and owner questions" carves a clear niche unlikely to collide with general skills, with only minor overlap risk against mail/notification-style skills. It fits "Mostly distinct; minor overlap risk" rather than 5, since the description lacks the concrete trigger phrases that would fully separate it.

4 / 5

Total

13

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 deeper-than-1-level

Warning

Total

13

/

16

Passed

Repository

vanillagreencom/kendex

Path

.agents/skills/mailbox/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.