Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is lean, well-structured, and gives concrete parameters and return-value semantics, with clear workflow clarity for a simple single-task skill. Its main weakness is actionability: the documented `proactive-send` command does not match the bundled `node scripts/send.mjs` entry point, and the referenced contract doc is absent from the bundle.
Suggestions
Align the documented command with the actual entry point — show `node scripts/send.mjs --user-id-external ... --text ...` (or document the `proactive-send` wrapper if one exists) so the example is copy-paste executable.
Either add the missing `docs/AWADA-CLIENT-TRANSPORT.md` to the bundle or remove the dangling reference so referenced paths resolve.
Clarify where `user_id_external` is read from (the params note says '对话上下文 Sender 块的 id 字段' — a one-line pointer to how to obtain it would make the example fully self-contained).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and well-sectioned (~37 lines) with no padding and no explanation of concepts Claude already knows; every line earns its place, matching 'lean and efficient; assumes Claude's competence.' | 3 / 3 |
Actionability | Params, return values, and the HTTP contract are concrete and a real script (send.mjs) exists, but the headline command `proactive-send ...` is not copy-paste executable — the bundled script's own header invokes `node scripts/send.mjs ...` — so the primary example is incomplete rather than fully executable. | 2 / 3 |
Workflow Clarity | This is a simple single-task skill whose single action is unambiguous, and the return-value section explicitly distinguishes success (exit 0, stream ID) from failure (exit 1, stderr), so the simple-skills carve-out allows a 3 for clear, well-organized workflow. | 3 / 3 |
Progressive Disclosure | At under 50 lines with cleanly organized sections and only a single one-level external pointer, the simple-skill carve-out allows a 3 for well-organized sections; the one pointer (docs/AWADA-CLIENT-TRANSPORT.md) is shallow rather than nested. | 3 / 3 |
Total | 11 / 12 Passed |