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".
86
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillEvaluation — 100%
↑ 1.96xAgent success when using this skill
Validation for skill structure
Discovery
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 effectively communicates when to use the skill and provides distinctive technical context that prevents conflicts with other messaging tools. However, it could benefit from more specific action verbs beyond 'send or manage' and additional natural trigger terms that users might actually say when wanting to text someone.
Suggestions
Expand the action list with specific capabilities like 'send texts, read conversations, search message history, send attachments'
Add natural trigger terms users would say: 'text message', 'send a text', 'message someone', 'Apple messages', 'iMessage'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (iMessages via BlueBubbles) and mentions two actions ('send or manage'), but lacks comprehensive concrete actions like 'read messages', 'search conversations', 'send attachments', etc. | 2 / 3 |
Completeness | Explicitly answers both what ('send or manage iMessages via BlueBubbles') and when ('Use when you need to send or manage iMessages') with clear trigger guidance including the technical detail about channel='bluebubbles'. | 3 / 3 |
Trigger Term Quality | Includes 'iMessages' and 'BlueBubbles' as relevant keywords, but misses common variations users might say like 'text message', 'iMessage', 'send a text', 'message someone', or 'Apple messages'. | 2 / 3 |
Distinctiveness Conflict Risk | Clearly distinguishes itself with specific platform references (BlueBubbles, iMessages) and technical implementation detail (channel='bluebubbles'), making it unlikely to conflict with other messaging skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill with excellent actionability through complete JSON examples and strong conciseness. The main weakness is the lack of validation guidance - there's no mention of how to verify a message was sent successfully, handle errors, or confirm the correct recipient before sending. For messaging operations, some verification steps would improve reliability.
Suggestions
Add a brief section on error handling or how to verify message delivery success
Include guidance on validating recipient/chat_guid before sending to prevent misdirected messages
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, providing only necessary information. It assumes Claude understands JSON, APIs, and messaging concepts without explaining basics. Every section serves a clear purpose. | 3 / 3 |
Actionability | Provides complete, copy-paste ready JSON examples for every action type. Each example includes all required fields with realistic placeholder values, making them immediately executable. | 3 / 3 |
Workflow Clarity | While individual actions are clear, there's no validation or error handling guidance. For messaging operations that could fail (wrong target, invalid messageId), there are no feedback loops or verification steps mentioned. | 2 / 3 |
Progressive Disclosure | Well-organized with clear sections (Overview, Inputs, Actions, Notes, Ideas). References developer documentation appropriately without deep nesting. Content is appropriately scoped for a skill file. | 3 / 3 |
Total | 11 / 12 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 — 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 | |
- 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.