blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

2.07x

Quality

56%

Does it follow best practices?

Impact

85%

2.07x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./openclaw/skills/blucli/SKILL.md

Quality

Discovery

40%

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 identifies a clear niche (BluOS CLI) which makes it distinctive, but it is too terse—listing only broad action categories without concrete specifics and entirely missing a 'Use when...' clause. Users searching for help with Bluesound speakers, multi-room audio, or music streaming might not trigger this skill due to missing natural language terms.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about BluOS, Bluesound speakers, multi-room audio setup, or controlling music playback via the blu CLI.'

Expand trigger terms to include natural user language like 'Bluesound', 'speakers', 'multi-room audio', 'music streaming', 'now playing', and 'speaker groups'.

List more specific concrete actions, e.g., 'Discovers BluOS players on the network, controls play/pause/skip, groups and ungroups speakers, adjusts volume levels.'

Dimension	Reasoning	Score
Specificity	Names the domain (BluOS CLI) and lists several action categories (discovery, playback, grouping, volume), but these are high-level categories rather than specific concrete actions like 'discover devices on network, play/pause/skip tracks, group speakers, adjust volume levels'.	2 / 3
Completeness	Describes what the skill does at a high level but completely lacks any 'Use when...' clause or explicit trigger guidance, which per the rubric should cap completeness at 2, and since the 'what' is also quite thin, this falls to 1.	1 / 3
Trigger Term Quality	Includes some relevant keywords like 'BluOS', 'blu', 'playback', 'volume', and 'grouping', but misses common user terms like 'speakers', 'music', 'audio', 'Bluesound', 'streaming', 'multi-room', or 'CLI commands'.	2 / 3
Distinctiveness Conflict Risk	BluOS CLI ('blu') is a very specific niche tool; it's unlikely to conflict with other skills given the distinct product name and CLI tool reference.	3 / 3
	Total	8 / 12 Passed

Implementation

72%

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 efficiently communicates how to use the blu CLI. Its greatest strength is token efficiency—it wastes nothing. It could be improved with slightly more complete command examples (showing full argument patterns) and explicit validation/confirmation steps for destructive operations like group modifications.

Suggestions

Show complete command examples with all required arguments for grouping operations (e.g., `blu group add <player_id>`) so Claude knows the exact syntax.

Add a brief validation step or expected output example after key commands (e.g., what `blu status` returns) to help Claude verify actions succeeded.

Dimension	Reasoning	Score
Conciseness	Extremely lean and efficient. Every line provides actionable information with zero unnecessary explanation. No concepts are over-explained; Claude's intelligence is fully respected.	3 / 3
Actionability	Provides concrete CLI commands that are copy-paste ready, but lacks complete examples of workflows (e.g., full grouping commands with arguments, what output to expect). Some commands like `blu group add` are missing required arguments.	2 / 3
Workflow Clarity	The quick start provides a reasonable sequence (discover → select → control), and there's a note to confirm target before changing playback. However, there are no explicit validation steps or error recovery guidance for potentially disruptive operations like grouping changes.	2 / 3
Progressive Disclosure	For a simple, short skill under 50 lines with a single-purpose CLI tool, the content is well-organized into logical sections (quick start, target selection, common tasks) with no need for external references.	3 / 3
	Total	10 / 12 Passed

Validation

72%

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 — 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

Repository: trpc-group/trpc-agent-go
Commit: 09cce3e

Reviewed: 5 days 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.