CtrlK
BlogDocsLog inGet started
Tessl Logo

sonoscli

Control Sonos speakers (discover/status/play/volume/group).

72

Quality

91%

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

The canonical home for this skill is sonoscli in deepgram/dglabs-deepclaw

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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 efficient, well-organized command reference: lean, fully executable, and clearly sectioned for a simple single-purpose skill. No improvements are needed against the rubric dimensions.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it jumps straight to commands with no explanation of what Sonos is or how CLI tools work, so every token earns its place.

3 / 3

Actionability

Commands are concrete and copy-paste ready with real flags and example values, e.g. 'sonos volume set 15 --name "Kitchen"' and 'sonos smapi search --service "Spotify" --category tracks "query"'.

3 / 3

Workflow Clarity

This is a simple single-purpose skill whose Quick start lays out an unambiguous discover -> status -> play -> volume sequence; per the simple-skills note, that clarity earns 3 without needing multi-step validation checkpoints.

3 / 3

Progressive Disclosure

Under 50 lines with no need for external references, the content is organized into clearly labeled Quick start, Common tasks, and Notes sections, which satisfies the under-50-lines exception for a top score.

3 / 3

Total

12

/

12

Passed

Description

82%

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 concise, specific, and distinctive, naming concrete Sonos operations in third person. Its only gap is the absence of explicit 'when to use' trigger guidance, which limits completeness.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when the user wants to control Sonos speakers — discovery, playback, volume, or grouping.'

Include a few natural trigger variations users might say, such as 'play music on Sonos' or 'group speakers', to strengthen trigger-term coverage.

DimensionReasoningScore

Specificity

The parenthetical '(discover/status/play/volume/group)' lists multiple concrete, specific actions rather than vague language, matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

It clearly states what the skill does ('Control Sonos speakers...') but provides no 'Use when...' or equivalent explicit trigger guidance, which the guidelines cap at 2 rather than the full 3.

2 / 3

Trigger Term Quality

Natural terms a user would say are well covered — 'Sonos speakers', 'play', 'volume', 'group' — aligning with the good-coverage anchor rather than the 'some relevant keywords but missing variations' level.

3 / 3

Distinctiveness Conflict Risk

The narrow Sonos-speaker niche with operation-specific triggers is clearly distinguishable and unlikely to fire for the wrong skill, matching the 'clear niche with distinct triggers' anchor.

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.

Validation13 / 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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository
Bitterbot-AI/bitterbot-desktop
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.