CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bluebubbles

Use when you need to send or manage iMessages via BlueBubbles (recommended iMessage integration). Calls go through the generic message tool with channel="bluebubbles".

63

Quality

79%

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/bluebubbles/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, highly actionable reference: complete JSON payloads for every action, a clear inputs checklist with a vague-user fallback, and honest caveats in Notes. The only real slack is the redundant "Ideas to try" section and an Overview that duplicates the description.

DimensionReasoningScore

Conciseness

The body is lean with no explanations of concepts Claude already knows, but the "Ideas to try" section largely duplicates the Actions examples and the Overview restates the frontmatter description. Not 5: those sections are trimmable padding.

4 / 5

Actionability

Every action (send, react, remove-reaction, edit, unsend, reply, sendAttachment, sendWithEffect) has a complete copy-paste-ready JSON payload with concrete field values, and the "Inputs to collect" section specifies target formats. Fully executable and covers the common cases.

5 / 5

Workflow Clarity

A simple single-tool skill where each action is an unambiguous one-shot call; the inputs checklist plus the explicit fallback ("If the user is vague ('text my mom'), ask for the recipient handle or chat guid") serves as the validation checkpoint. No destructive or batch operations, so the workflow cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist; the body is well-sectioned with one clearly signaled one-level-deep pointer ("extensions/bluebubbles/README.md"). Not 5: at ~127 lines it exceeds the under-50-line simple-skill bar, and the marginal "Ideas to try" section could be cut or split out.

4 / 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.

A concise, honest description with an explicit use-when clause and a clearly branded, distinctive niche. Its weaknesses are thin capability enumeration ("send or manage" hides tapbacks, edits, attachments, effects) and limited trigger vocabulary beyond the word "iMessages".

Suggestions

Enumerate the concrete capabilities in the description, e.g. "send texts and attachments, add tapbacks, edit or unsend messages, reply in threads" — this would raise specificity from 3 to 4-5.

Add natural trigger synonyms users actually say, such as "text", "tapback/react", or "reply in a thread", so the skill fires on phrasing beyond just "iMessages".

Sharpen the when-clause with distinct triggers (e.g. "Use when the user wants to text someone via iMessage, add a reaction, or manage a group chat") instead of restating the what.

DimensionReasoningScore

Specificity

"send or manage iMessages" names the domain plus one to two actions, but "manage" is generic and the rich capabilities (tapbacks, edits, attachments, effects) are absent. Not 4: it does not list several specific concrete actions.

3 / 5

Completeness

The explicit "Use when you need to send or manage iMessages" clause gives a when, and the what names the tool path ("generic message tool with channel=\"bluebubbles\""). Not 5: the when-clause nearly restates the what rather than adding concrete, distinct trigger phrases.

4 / 5

Trigger Term Quality

"iMessages" and "send" are natural user terms, but common variations like "text", "tapback", "react", or "SMS" are missing. Not 4: keyword coverage is relevant but not broad enough to be a few-short-of-comprehensive case.

3 / 5

Distinctiveness Conflict Risk

"BlueBubbles", "iMessages", and channel="bluebubbles" carve a clear niche, but "send messages" language overlaps with other messaging-channel skills. Not 5: minor overlap risk remains with closely related message-sending skills.

4 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

Bitterbot-AI/bitterbot-desktop

Path

skills/bluebubbles/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.