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 highly actionable and well-sequenced with strong failure-handling feedback loops, but it loses token efficiency through repeated mechanism explanations across the three scenarios, and its bundle references are not explicitly signaled as navigable links.
Suggestions
Factor the "无 cookie SSR HTML 路线 / cookie 仅回退 / exit 2 → login-manager" rationale into a single '下载路线' section and reference it from scenarios A/B/C instead of repeating it verbatim three times.
Add a one-level-deep signaled reference to the script (e.g. a 'See scripts/fetch_note_content.ts' link and/or move the full parameter/exit-code table to a reference file) to improve progressive disclosure.
Consider moving the detailed --url/--note-id/--xsec-token parameter table and JSON output schema out of the main body into a scripts/README or reference doc, keeping the main SKILL.md a concise overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and operational (tables, commands, exit codes), but the "无 cookie SSR HTML 路线…cookie 仅回退…exit 2 交 login-manager" rationale and the login-manager fallback instructions repeat verbatim ~3× across scenarios A/B/C, which could be factored once. It is efficient, not padded with concepts Claude already knows, so it stays above 1. | 2 / 3 |
Actionability | It provides copy-paste-ready commands (e.g. `camoufox-cli --session xhs-browse --persistent --json open "..."`, `xhs-content-ops --url <url> --output-dir ...`), concrete exit codes (0/1/2), an exact JSON output schema, and a parameter table — fully executable guidance. | 3 / 3 |
Workflow Clarity | Three scenarios are clearly numbered and sequenced, with explicit validation/feedback loops for risky batch operations (exit 2 → login-manager re-login → retry once; NO_XSEC_TOKEN/NEED_VERIFY handling) and a structured failure-handling table, satisfying the batch-operation feedback-loop requirement. | 3 / 3 |
Progressive Disclosure | Bundle files exist (scripts/fetch_note_content.sh, .ts) and are invoked via the real PATH wrapper `xhs-content-ops`, and sections are well organized, but references are not signaled as navigable links and substantial parameter/API detail sits inline in the body rather than split into a one-level-deep signaled reference. Not 3 because there is no clear 'See X' one-level-deep pointer; not 1 because structure is present and references are real. | 2 / 3 |
Total | 10 / 12 Passed |