Control Sonos speakers (discover/status/play/volume/group).
76
Quality
68%
Does it follow best practices?
Impact
96%
16.00xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/sonoscli/SKILL.mdQuality
Discovery
50%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 specific capabilities for Sonos speaker control with good distinctiveness due to the brand-specific focus. However, it critically lacks any 'Use when...' guidance, which is essential for Claude to know when to select this skill from a large skill library. The trigger terms could also be expanded to include more natural user language around music and audio control.
Suggestions
Add a 'Use when...' clause with trigger terms like 'play music', 'Sonos', 'speaker control', 'adjust volume', 'smart speaker'
Include common user phrases like 'music playback', 'audio', 'pause', 'skip track', 'playlist' to improve trigger term coverage
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions in parentheses: discover, status, play, volume, and group. These are clear, actionable capabilities for speaker control. | 3 / 3 |
Completeness | Describes what it does (control Sonos speakers with specific actions) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes 'Sonos speakers' which is a strong natural keyword, but missing common variations users might say like 'music', 'audio', 'pause', 'skip', 'playlist', or 'smart speaker'. | 2 / 3 |
Distinctiveness Conflict Risk | 'Sonos' is a specific brand name that creates a clear niche. This is unlikely to conflict with other skills unless there are multiple Sonos-related skills. | 3 / 3 |
Total | 9 / 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, concise skill that provides actionable CLI commands without unnecessary explanation. The troubleshooting section is particularly valuable with specific error messages and remediation steps. Minor improvement could be made by showing multi-step workflows for complex operations like setting up Spotify playback.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient. No unnecessary explanations of what Sonos is or how CLI tools work. Every line provides actionable information Claude needs. | 3 / 3 |
Actionability | Provides concrete, copy-paste ready commands for all common operations. Commands are complete with flags and examples, not pseudocode or vague descriptions. | 3 / 3 |
Workflow Clarity | Commands are clear but presented as a reference list rather than workflows. For operations like grouping speakers or playing from Spotify, the sequence of steps isn't explicit. The troubleshooting section provides good error recovery guidance. | 2 / 3 |
Progressive Disclosure | For a skill of this size (~40 lines), the structure is appropriate. Clear sections for quick start, common tasks, notes, and troubleshooting. No need for external file references given the scope. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 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 |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
50ef2f3
Table of Contents
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.