songsee
Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
80
75%
Does it follow best practices?
Impact
96%
19.20xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/songsee/SKILL.mdQuality
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 is specific about its capabilities and clearly occupies a distinct niche with the songsee CLI tool. However, it critically lacks a 'Use when...' clause, which means Claude has no explicit guidance on when to select this skill. Adding trigger guidance and a few more natural keyword variations would significantly improve it.
Suggestions
Add a 'Use when...' clause, e.g., 'Use when the user wants to visualize audio, generate spectrograms, or create feature-panel plots from audio files.'
Include additional natural trigger terms users might say, such as 'audio visualization', 'frequency analysis', 'mel spectrogram', 'waveform', or file extensions like '.wav', '.mp3'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists specific concrete actions: 'Generate spectrograms and feature-panel visualizations from audio' and names the specific tool 'songsee CLI'. These are concrete, well-defined capabilities. | 3 / 3 |
Completeness | Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent, this scores a 1. | 1 / 3 |
Trigger Term Quality | Includes good terms like 'spectrograms', 'audio', and 'songsee CLI', but misses common variations users might say such as 'audio analysis', 'frequency plot', 'waveform', 'mel spectrogram', or 'audio visualization'. | 2 / 3 |
Distinctiveness Conflict Risk | Highly distinctive due to the specific tool name 'songsee CLI' and the narrow domain of spectrogram/feature-panel generation from audio. Very unlikely to conflict with other skills. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent, lean skill file for a CLI tool. It provides concrete, executable examples covering all major use cases, organizes flags and notes cleanly, and wastes no tokens on explanations Claude doesn't need. A model example of a concise, single-purpose skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line earns its place. No unnecessary explanations of what spectrograms are or how audio processing works. Assumes Claude's competence and provides only the CLI-specific information needed. | 3 / 3 |
Actionability | Provides fully executable, copy-paste ready CLI commands covering the main use cases (basic spectrogram, multi-panel, time slicing, stdin piping). Flag reference is concrete and specific. | 3 / 3 |
Workflow Clarity | This is a simple, single-purpose CLI tool skill. The quick start examples clearly show the progression from basic to advanced usage. No destructive or batch operations requiring validation checkpoints. | 3 / 3 |
Progressive Disclosure | For a simple CLI skill under 50 lines, the content is well-organized into logical sections (quick start, common flags, notes) with no need for external references. Structure is clean and navigable. | 3 / 3 |
Total | 12 / 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.
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
af8bd5f
- 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.