Content
100%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.
An exceptionally well-engineered skill body: lean rule-dense prose, executable commands with concrete examples, a complete error-recovery table with explicit stop conditions, and consent-gated destructive operations. The only artifact worth noting is the {{CHANNEL_TABLE}}/{{VERSION}} template placeholders, which are build-time substitutions compensated for by the instruction to consult `agent-reach channels` for the live action list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is telegraphic and every line instructs (e.g. "正文、评论、字幕分别核对是否已拿到;够了就直接回答,不装渠道、不登录") with zero explanation of concepts Claude already knows. It matches anchor 5 (lean, every token earns its place); anchor 4 would require trimmable over-explanation, and the only repetition (stop-rules echoed across error-table rows) keeps each row self-contained for mid-task lookup rather than padding. | 5 / 5 |
Actionability | Fully executable guidance: a copy-paste example (`agent-reach xiaohongshu search "咖啡" --limit 5`), per-error remediation commands (`agent-reach add <渠道>`, `agent-reach configure <key>`, `agent-reach doctor --text`), and a user-intent-to-command mapping table. Anchor 5's 'specific examples cover the common cases' is met; the {{CHANNEL_TABLE}}/{{VERSION}} strings are build-time substitutions and the body routes uncertain cases to `agent-reach channels` for the authoritative action list, leaving no executable gap. | 5 / 5 |
Workflow Clarity | The routing workflow has an explicit verification checkpoint ("正文、评论、字幕分别核对是否已拿到"), the 9-code error table provides feedback loops with explicit stop conditions ("不循环重试", "按 retry_after_seconds 等", "过一会儿…再试"), and destructive operations are gated (`agent-reach uninstall --dry-run` → user confirms → run; update only after consent). This matches anchor 5 (explicit validation steps, feedback loops for error recovery); anchor 4's 'minor validation gaps' is not met. | 5 / 5 |
Progressive Disclosure | The ~105-line body stays an overview while delegating detail to three one-level-deep references, each verified to exist in the bundle and each with an explicit read-trigger: "用户要登录、退出、换账号,或遇到 NEED_LOGIN 时读它" (references/sessions.md), "用户问'能查什么/查得全吗'或要判断结果完整度时读它" (references/capabilities.md), and "更新失败、浏览器起不来或要卸载时读它" (references/maintenance.md). None of the three references points to further files, so navigation is exactly one level deep — anchor 5. | 5 / 5 |
Total | 20 / 20 Passed |