CtrlK
BlogDocsLog inGet started
Tessl Logo

beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

63

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/beeper/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 exemplary lean, single-purpose skill: concrete DB paths, executable probes, a clear ordered workflow, and a thoughtful privacy note, all within a tight token budget. The only meaningful gap is slightly underspecified detail on the room/participant lookup steps, which keeps actionability and workflow clarity at 4 rather than 5.

DimensionReasoningScore

Conciseness

The body is lean and efficient with zero padding — it states the DB path, the FTS table, a four-step workflow, two probe commands, and a one-line privacy note. Every line assumes Claude's competence and nothing explains concepts Claude already knows, matching the top anchor exactly.

5 / 5

Actionability

Two copy-paste-ready sqlite3 commands with the real DB path and a working FTS query form provide mostly executable guidance, with minor gaps: the room and participant tables are referenced generically ("room tables") without exact names, and the FTS match term is an unfilled 'query' placeholder. It falls short of 5 because the common cases aren't fully covered with concrete, ready-to-run examples for each step.

4 / 5

Workflow Clarity

A clear four-step sequence (identify account/room → FTS discovery → narrow by date/participant/room → report names, spans, confidence) with an explicit "Start by inspecting accounts/rooms before broad searching" ordering hint. The queries are read-only, so the destructive-operation cap does not apply; it stays below 5 because there are no explicit validation checkpoints (e.g. verifying a match actually belongs to the suspected room) and step 3 "Narrow by date, participant, and room" lacks concrete commands.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (no bundle files exist), and the content is organized into clean Source, Workflow, and probe sections with no inlined material that belongs in a separate file. Per the rubric's simple-skill guideline, well-organized sections alone merit the top score here.

5 / 5

Total

18

/

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 is distinct and reasonably specific, naming the Beeper niche and several concrete capabilities, but it reads as a telegraphic keyword list rather than a trigger-optimized description. It lacks any "Use when…" guidance and natural trigger phrases users would actually say, which limits discoverability.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks about Beeper chat history, searching past WhatsApp/iMessage messages, or identifying who sent a message from a vague contact hint."

Replace jargon like "FTS" with natural synonyms users would say, such as "full-text search", "chat history", and "search messages".

Convert the noun fragments into third-person action statements (e.g. "Looks up rooms and accounts, traces WhatsApp/iMessage messages, and runs full-text searches over local Beeper history") so the description states what the skill does rather than just naming topics.

DimensionReasoningScore

Specificity

Lists several concrete capabilities — "contact hints", "room lookup", "WhatsApp/iMessage traces", "FTS" — but they are noun fragments rather than actions and coverage of what the skill does is terse. It sits above score 3 (only 1-2 concrete actions) but below 5 (comprehensive, explicit action coverage).

4 / 5

Completeness

The "what" is stated concretely (contact hints, room lookup, message traces, FTS), but there is no "Use when…" clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not score 2 because the "what" is clear rather than vague, and not 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Includes relevant keywords like "Beeper", "WhatsApp", "iMessage", and "contact hints", but "FTS" is technical jargon and common natural phrases users would say — "chat history", "search messages", "find a conversation" — are missing. Not notably below this midpoint (score 2 has only generic keywords), but clearly short of good coverage at 4.

3 / 5

Distinctiveness Conflict Risk

"Beeper cache" names a specific application with distinct triggers (WhatsApp/iMessage bridges, contact hints), giving it a clear niche with minimal conflict risk against other skills. No neighboring anchor fits better: 4 would imply meaningful overlap with closely related skills, which is not the case.

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
steipete/agent-scripts
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.