Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a strongly actionable, well-sequenced production workflow with explicit error-recovery checkpoints and a complete output schema, but it is front-loaded with verbose ASR provisioning prose and carries a broken _shared/* reference that holds back conciseness and progressive disclosure.
Suggestions
Move the detailed 火山 ASR provisioning/auth guide into a separate reference file (e.g., references/asr-setup.md) and keep only the essential env-var table + a one-line link in SKILL.md.
Fix or remove the inline references to _shared/check-session.ts and _shared/xhs-html-note.ts, which do not exist in the provided scripts bundle; either add those files or point to the actual session.ts / platforms/xhs.ts paths.
Trim explanatory rationale (e.g., why subagents help) to one line so the operational steps stay token-efficient.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core workflow is operational and Claude-specific, but the front-loaded ASR provisioning prose (console navigation, auth-quirk blockquotes, interface-selection rationale) and the subagent rationale are padded enough to keep it at "mostly efficient but could be tightened." | 2 / 3 |
Actionability | It provides copy-paste-ready commands (mkdir, viral-chaser <url> [--no-frames]), the exact stdout JSON schema, explicit env vars, and concrete Read-tool usage, matching the fully-executable anchor. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced (workspace → analyzer → frames → framework → handoff) with explicit validation checkpoints: exit codes 0/1/2, SESSION_EXPIRED retry-once via login-manager, SIGN_UNAVAILABLE escalation, and the transcript.estimated flag handling. | 3 / 3 |
Progressive Disclosure | There is section structure and a real scripts bundle, but content that could be split (the long ASR provisioning guide) is inline, and inline references to _shared/check-session.ts and _shared/xhs-html-note.ts do not exist in the bundle, so references are present but not cleanly signaled/organized. | 2 / 3 |
Total | 10 / 12 Passed |