CtrlK
BlogDocsLog inGet started
Tessl Logo

openhue

Control Philips Hue lights/scenes via the OpenHue CLI.

62

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/openhue/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

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 exemplary lean CLI reference: fully executable commands with example values organized into a coherent setup/read/write flow, with no padding or over-explanation. The only meaningful gap is the absence of a post-write verification step, which is minor for this low-risk domain. No bundle files exist, and none are needed at this size.

DimensionReasoningScore

Conciseness

The ~30-line body is lean and efficient: one orienting sentence, then bare command lines with no concept explanations ('Use `openhue` to control Hue lights and scenes via a Hue Bridge.'). Every token earns its place, matching the top anchor.

5 / 5

Actionability

Every line is a copy-paste-ready command with concrete example values ('openhue set light <id> --on --brightness 50', '--rgb #3399FF', 'openhue get light --json'), covering the common cases of setup, discovery, on/off, brightness, color, and scenes per the top anchor.

5 / 5

Workflow Clarity

The Setup → Read (discover IDs via `get ... --json`) → Write sequence is clear, matching 'Clear sequence with most checkpoints present'. It falls short of 5 only because there is no verification step after writes (e.g., re-running `openhue get light --json` to confirm the change), and it sits above 3 because the sequence and the disambiguation note ('--room "Room Name"') are explicit.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (none exist in the bundle), and its Setup/Read/Write/Notes sections are well-organized — the rubric's simple-skill guideline scores this a 5.

5 / 5

Total

19

/

20

Passed

Description

57%Weight 40%Scale 1-5

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, accurate, and highly distinctive, but it functions only as a 'what' statement. It enumerates just one generic action verb and entirely lacks 'Use when...' trigger guidance, which caps both completeness and trigger-term quality. Adding an explicit trigger clause and naming the concrete operations would lift it substantially.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the user mentions Hue, smart lights, dimming, or wants to turn lights on/off, change brightness/color, or activate scenes.'

Enumerate the concrete capabilities instead of the single verb 'Control': turning lights on/off, setting brightness and RGB color, and activating scenes.

Include natural synonyms users would actually say (smart lights, dim/brighten, Hue Bridge) to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Philips Hue lights/scenes') and the single generic action 'Control', matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It does not list several specific actions (on/off, brightness, color) required for a 4.

3 / 5

Completeness

It has a clear 'what' ('Control Philips Hue lights/scenes via the OpenHue CLI') but no 'Use when...' clause or equivalent trigger guidance; the judging guidelines explicitly cap completeness at 3 in that case. It is above anchor 2 because the 'what' is concrete, not vague.

3 / 5

Trigger Term Quality

'Philips Hue', 'lights', and 'scenes' are relevant natural keywords, but common variations users would say — 'smart lights', 'dim', 'turn on/off', 'Hue Bridge' — are missing, fitting the 'Some relevant keywords but missing common variations or synonyms' anchor rather than the 'a few natural terms missing' level of 4.

3 / 5

Distinctiveness Conflict Risk

'Philips Hue lights/scenes via the OpenHue CLI' carves out a clear niche with distinct triggers (brand + product-specific CLI); there is minimal risk of this triggering for the wrong skill, matching the top anchor.

5 / 5

Total

14

/

20

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 — 13 / 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.