CtrlK
BlogDocsLog inGet started
Tessl Logo

music-search

Search cloud drives for downloadable music resources (songs, albums, lossless audio). Use this skill when the user wants to download a specific song or album. Do NOT use for general music information, lyrics, or recommendations.

68

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

A highly actionable, well-structured skill body: every command is copy-paste ready, the output contract is fully specified, and the agent workflow includes a sensible resolve fallback. Remaining gaps are minor: some duplicated guidance on engine choice, no error/empty-result handling in the workflow, and no reference-file split for the longer specification sections.

Suggestions

Consolidate the deep-vs-web engine tradeoff into one section (remove the duplicate timing/accuracy remarks in 注意事项) to tighten conciseness.

Add a short step to the Agent 使用流程 for empty or failed results (e.g. retry with alternate keywords or --engine web) to create a feedback loop in the workflow.

Move the JSON output schema and field dictionary into a references/output-format.md and actually ship the documented music-search/.env (or its template) so every referenced path exists in the bundle.

DimensionReasoningScore

Conciseness

The body is operational throughout — command syntax, an options table, copy-paste examples, output JSON schema, and env config — with no explanations of concepts Claude already knows. It stops short of anchor 5 because the deep-vs-web engine tradeoff is stated twice ("引擎说明" and "注意事项") and the disclaimer tail adds little operational value.

4 / 5

Actionability

All commands are fully executable ("bash \"$SKILLS_ROOT/music-search/scripts/music-search.sh\" search \"周杰伦 范特西\" --pan quark --format flac") with five varied examples plus a PowerShell variant, and the documented output JSON and field semantics let the agent parse results directly. Verified against the bundle: the search/hot/resolve subcommands and --pan/--format/--limit/--engine flags all exist in scripts/music-search.js, matching the documented interface exactly.

5 / 5

Workflow Clarity

The "Agent 使用流程" section gives a clear 5-step sequence with a conditional fallback ("如果结果中有 pageUrl 但没有直接 url,用 resolve 命令获取真实地址") and a worked example dialogue. It is not 5 because there are no checkpoints for failure cases — empty results, failed requests, or dead links are only hinted at in the notes rather than handled as feedback loops in the workflow.

4 / 5

Progressive Disclosure

Well-organized sections (prerequisites, commands, agent flow, output format, config, notes) with script references that point to real bundle files (scripts/music-search.sh, .ps1, and the underlying .js/deep-extract.js, all verified present). It is below anchor 5 because everything is inlined in SKILL.md — the JSON output schema, field dictionary, and .env config reference could live in a separate reference file — and the referenced music-search/.env file does not exist in the bundle.

4 / 5

Total

17

/

20

Passed

Description

82%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.

A strong description: concrete what/when structure with useful negative triggers and good natural-language keywords. The main gap is that it names only one action (searching) and omits format-level synonyms (flac, mp3) that users commonly say.

DimensionReasoningScore

Specificity

"Search cloud drives for downloadable music resources (songs, albums, lossless audio)" names the domain and one concrete action with specific resource types, but only lists a single action (search) rather than several (e.g. no mention of filtering by format, resolving links, or hot recommendations). It is above score 2 because the action is concrete with a defined scope, and below score 4 because anchor 4 requires several specific actions.

3 / 5

Completeness

It explicitly answers what ("Search cloud drives for downloadable music resources") and when ("Use this skill when the user wants to download a specific song or album"), and adds negative triggers ("Do NOT use for general music information, lyrics, or recommendations") matching the anchor-5 example's structure. Score 4 is ruled out because the 'when' clause is concrete, not merely present.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: "download a specific song or album", "music", "lossless audio", "cloud drives". It falls short of anchor 5 because common synonyms and format extensions users actually say (flac, mp3, Hi-Res, track) are absent, but coverage is clearly better than the 'some relevant keywords' of anchor 3.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (downloadable music resources on cloud drives) and the explicit exclusion clause ("Do NOT use for general music information, lyrics, or recommendations") sharply separates it from music-info/lyrics/recommendation skills, minimizing conflict risk. It clearly fits anchor 5's 'clear niche with distinct triggers'.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
netease-youdao/LobsterAI
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.