Content
82%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |