Content
90%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.
The body is an efficient, highly actionable reference: executable commands with explicit JSON contracts, compact schema tables, and clear check-before/record-after dedup rules. Its only weaknesses are minor — no error-response handling in the workflows and an unexplained relationship between the PATH wrapper and the bundled scripts.
Suggestions
Add one line of error handling to the usage rules: on '{"ok": false, "error": ...}' report the error and do not mark the creator/post as recorded (so the dedup state stays truthful).
Briefly connect the 'bd-record' PATH wrapper to the scripts/ bundle (one line, e.g. which subcommand maps to which script) so the invocation path is self-explanatory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and efficient — compact schema tables, bare executable commands with flags, and JSON return formats — with no explanation of concepts Claude already knows; every token earns its place, matching the 'lean and efficient' anchor. | 5 / 5 |
Actionability | All commands are copy-paste ready with full argument lists (e.g. 'bd-record record-creator --platform ... --notes <备注>'), each returns an explicit JSON contract (e.g. '{"ok": true, "id": <记录ID>}' or '{"ok": false, "error": "..."}'), and init is stated as idempotent — fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | Both modes have an explicit check-before → skip-if-exists → record-after sequence with real checkpoints ('打开创作者主页前先用 check-creator 判断…已在记录中则跳过'), but there is no guidance for handling '{"ok": false, "error": ...}' responses or recovering from failed writes — a minor validation gap that keeps it below level 5. | 4 / 5 |
Progressive Disclosure | Content is appropriately inline for a skill this compact, organized into clear sections (location, schema, commands, rules). Minor gap: the scripts/ bundle and the 'bd-record' PATH wrapper are never connected — the body says not to splice script paths but never explains how the wrapper maps to the bundled scripts, so organization is good but not fully self-navigating. | 4 / 5 |
Total | 18 / 20 Passed |