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".

1.96x

Quality

76%

Does it follow best practices?

Impact

100%

1.96x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/bluebubbles/SKILL.md

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A solid, actionable skill with excellent concrete JSON examples for every supported action. The content is well-structured and immediately usable, though it could be slightly more concise by trimming the 'Ideas to try' section and tightening the overview. Progressive disclosure is adequate but could benefit from splitting advanced actions into a referenced file.

Suggestions

Remove the 'Ideas to try' section — these are obvious use cases that Claude can infer from the action examples.

Trim the overview paragraph to avoid restating what the action examples already demonstrate (e.g., remove the enumeration 'send texts and attachments, react (tapbacks), edit/unsend...').

Dimension	Reasoning	Score
Conciseness	Mostly efficient with good use of JSON examples, but the 'Ideas to try' section and some notes are somewhat unnecessary filler. The overview paragraph also restates what the examples already demonstrate. The 'Inputs to collect' section is useful but slightly verbose.	2 / 3
Actionability	Every action has a complete, copy-paste-ready JSON payload with realistic field values. The inputs section clearly specifies formats (E.164, chat_guid prefix). Claude can directly use these examples to construct tool calls.	3 / 3
Workflow Clarity	This is a single-action-per-call skill (not a multi-step workflow), and each action is unambiguous with clear JSON schemas. The guidance on when to ask for clarification ('If the user is vague...') adds appropriate handling. No destructive batch operations require validation loops.	3 / 3
Progressive Disclosure	References the developer docs at `extensions/bluebubbles/README.md` which is good, but no bundle files are provided to verify. The skill is somewhat long with all actions inline; grouping less common actions (edit, unsend, effects) into a separate reference file could improve organization, though for a skill of this size it's borderline acceptable.	2 / 3
	Total	10 / 12 Passed

Description

75%

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 has good completeness with an explicit 'Use when' clause and is distinctively scoped to BlueBubbles iMessage integration. However, it lacks specificity in the concrete actions it can perform beyond 'send or manage', and could benefit from more natural trigger terms that users would actually say. The description also uses second person ('you need to') which is not ideal per the rubric guidelines.

Suggestions

List more specific concrete actions such as 'send, read, search, and manage iMessages' to improve specificity.

Add natural trigger term variations like 'text message', 'texting', 'SMS', 'chat', or 'Apple Messages' to improve discoverability.

Dimension	Reasoning	Score
Specificity	Names the domain (iMessages via BlueBubbles) and mentions two actions ('send or manage'), but doesn't list specific concrete actions like reading conversations, sending attachments, searching messages, etc.	2 / 3
Completeness	Explicitly answers both 'what' (send or manage iMessages via BlueBubbles) and 'when' (starts with 'Use when you need to send or manage iMessages'). The 'Use when' clause is present and clear.	3 / 3
Trigger Term Quality	Includes relevant keywords like 'iMessages', 'BlueBubbles', 'message', and 'send', but misses common user variations like 'text message', 'iMessage', 'SMS', 'chat', or 'texting'. The technical detail about channel='bluebubbles' is implementation-focused rather than user-facing.	2 / 3
Distinctiveness Conflict Risk	Clearly scoped to iMessages via BlueBubbles specifically, with the channel='bluebubbles' detail further distinguishing it. Unlikely to conflict with other messaging or communication skills.	3 / 3
	Total	10 / 12 Passed

Validation

81%

Warnings & errors only

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

Validation — 9 / 11 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning

	Total	9 / 11 Passed

Repository: attilaczudor/Test
Commit: b4fc4af

Reviewed: 2 months ago

Table of Contents

Discovery Implementation Validation

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.