Content
71%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-sequenced workflow with strong error-handling guidance, though it leans verbose in places and contains broken bundle references plus inline content that could be externalized.
Suggestions
Fix or remove the `_shared/check-session.ts` and `_shared/xhs-html-note.ts` references — these paths do not exist in the bundle; point to the actual `scripts/session.ts` location or drop the inline path citations.
Tighten the 「前置：开通火山语音模型」 console-navigation steps and the ASR 接口选型 aside, or move them into a separate reference doc linked from SKILL.md, to reduce inline token weight.
Add an explicit validation checkpoint after Step 2 (e.g., "only proceed to analysis when `ok` is true; otherwise follow the exit-code recovery below") to close the workflow gate.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and rich with non-obvious operational gotchas (auth quirks, exit codes, exec allowlist), but the multi-step 火山 console navigation and the ASR 接口选型 aside comparing four tiers are over-explanatory and could be trimmed. | 3 / 5 |
Actionability | Copy-paste ready commands (mkdir, VIDEO_SLUG, `viral-chaser <url> [--no-frames]`), a fully specified JSON output schema, documented exit codes with recovery flows, and a concrete tabular analysis framework. | 5 / 5 |
Workflow Clarity | Clear Step 1→2→3 sequence with built-in probing and explicit exit-code validation plus a retry feedback loop for session expiry, but the "proceed with analysis" gate is implicit rather than an explicit ok-check checkpoint. | 4 / 5 |
Progressive Disclosure | Reasonable section structure and a real code bundle, but body references `_shared/check-session.ts` and `_shared/xhs-html-note.ts` which do not exist in the bundle (only `scripts/` exists), and substantial operational detail (auth setup, analysis framework) is inlined rather than split into reference files. | 3 / 5 |
Total | 15 / 20 Passed |