CtrlK
BlogDocsLog inGet started
Tessl Logo

songsee

Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.

68

Quality

83%

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

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 exemplar of a lean, actionable reference for a simple CLI tool: concrete commands, a compact flag list, and brief notes with no filler. The simple-skill nature means it earns top marks without external files or multi-step workflows.

DimensionReasoningScore

Conciseness

The body is lean—quick-start commands, a compact flag list, and terse notes with no over-explanation of concepts Claude already knows; it is not the level below because nothing here reads as padded or tighten-able.

3 / 3

Actionability

Examples like 'songsee track.mp3', the full multi-panel --viz command, and the stdin pipe are fully executable and copy-paste ready with concrete flag values; it is not the level below because there is no pseudocode or missing key details.

3 / 3

Workflow Clarity

This is a simple single-purpose CLI skill where the single action is unambiguous, so the simple-skills exception allows a top score; it is not the level below because the usage patterns are clearly presented and there are no destructive or batch operations requiring validation checkpoints.

3 / 3

Progressive Disclosure

At under 50 lines with no need for external references, the well-organized Quick start / Common flags / Notes sections satisfy the simple-skills exception; it is not the level below because content is appropriately inline and clearly sectioned rather than monolithic or poorly organized.

3 / 3

Total

12

/

12

Passed

Description

67%

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 specific and distinctive, naming concrete audio-visualization actions and a clear niche. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which limits trigger-term coverage and completeness.

Suggestions

Add an explicit trigger clause, e.g. 'Use when you need to visualize audio, generate spectrograms, or inspect audio features like mel/chroma/tempogram.'

Broaden trigger terms with natural user phrasing such as 'visualize audio', 'audio analysis', or 'waveform' rather than only 'feature-panel visualizations'.

DimensionReasoningScore

Specificity

Phrases 'Generate spectrograms and feature-panel visualizations' name multiple specific concrete actions in the audio domain, matching the multiple-concrete-actions anchor; it is not the level below because it is not merely naming a domain with partial actions.

3 / 3

Completeness

The description answers 'what' (generate spectrograms and feature panels from audio) but lacks any 'Use when...' or equivalent explicit trigger guidance for when to use it, which per the guidelines caps completeness at 2; it is above 1 because the 'what' is clearly stated.

2 / 3

Trigger Term Quality

Terms like 'spectrograms', 'audio', and 'feature-panel visualizations' are relevant but 'feature-panel visualizations' leans technical and common user variations ('visualize audio', 'audio analysis', 'waveform') are absent; it does not reach 3 because natural-term coverage is incomplete.

2 / 3

Distinctiveness Conflict Risk

The named songsee CLI plus the specific audio-spectrogram niche make it clearly distinguishable and unlikely to trigger for unrelated skills; it is not the level below because it is not a generic 'works with files' style description.

3 / 3

Total

10

/

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.