CtrlK
BlogDocsLog inGet started
Tessl Logo

sonoscli

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

76

16.00x

Quality

68%

Does it follow best practices?

Impact

96%

16.00x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./openclaw/skills/sonoscli/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation8 / 11 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

8

/

11

Passed

Repository
trpc-group/trpc-agent-go
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.