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 lean, highly actionable CLI skill: executable commands for every subcommand, concrete error taxonomy with exit codes and recovery loops, and strict data-integrity rules. The main gaps are the missing post-write validation checkpoint and weakly signaled navigation to the three bundle scripts in scripts/.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational text with no filler and no explanation of concepts Claude already knows ('脚本临时从 Camoufox 持久化 session douyin 的 profile 读取 cookie 和 UA…凭据只保留在进程内存'). Only the cold-start browser-session mechanics paragraph describes script internals rather than instructions to Claude, so it falls just short of the 'every token earns its place' anchor. | 4 / 5 |
Actionability | The bash block gives copy-paste-ready commands covering all four subcommands ('douyin-engagement check / list / fetch --row-id 12 / daily') with an argument example, plus the exact recovery flow ('执行 douyin-publish login…完成后重跑 check') and concrete exit codes (SESSION_EXPIRED exit 2, PROFILE_SESSION_UNAVAILABLE exit 1). This matches the 'fully executable, covers the common cases' anchor. | 5 / 5 |
Workflow Clarity | The flow is clear with a real feedback loop (check → login → re-check on SESSION_EXPIRED) and enumerated failure conditions with handling rules ('未找到作品、游标异常、接口空体、风控即报告原因'). It falls short of anchor 5 because there is no explicit post-write verification step after 'published-track update-metrics 写库', and the sequence is spread across prose rather than an ordered list. | 4 / 5 |
Progressive Disclosure | For a ~25-line skill, inline content is appropriately sized, and the one named bundle file ('fetch-retro-data.ts') exists in scripts/. Minor gaps keep it below anchor 5: no section headers, the script reference is not path-linked, and the other two bundle scripts (douyin-web.ts, douyin_engagement.py) are never referenced, so navigation to the bundle is weakly signaled. | 4 / 5 |
Total | 17 / 20 Passed |