Content
88%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.
A tight, safety-conscious instruction body with executable command examples and exemplary validation/confirmation checkpoints for a destructive-capability skill. The only real gaps are minor: unshown syntax for the verification commands and no pointer to the bundled script.
Suggestions
Reference the implementing script explicitly, e.g. 'run via scripts/douyin_interact.py', so the bundle structure is discoverable from the body.
Add one example for favorite (and note collection-move/collection-remove exist) since the script supports them but the body only names unlike/favorite in passing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence carries operational information — verification commands, session path, confirm flag semantics, error codes, retry policy — with zero concept explanation or padding. The body is lean and assumes Claude's competence. | 5 / 5 |
Actionability | The three bash examples are copy-paste ready with real flags (--url, --text, --comment-id, --confirm), covering the common like/comment/reply cases. Minor gaps: the douyin-hunter verification commands are named but not shown with syntax, and favorite/unfavorite/collection invocations are never exemplified. | 4 / 5 |
Workflow Clarity | The sequence is explicit and well-checkpointed for a write-operation skill: verify target first, preview by default, require user confirmation via --confirm, submit exactly once, and on timeout/ambiguous results check the platform rather than auto-retry, with named error codes (SIGN_UNAVAILABLE, UNSUPPORTED_OPERATION) treated as failures. | 5 / 5 |
Progressive Disclosure | For a short single-purpose skill the body is appropriately compact with no inlined bulk, but it never points to the bundled scripts/douyin_interact.py that implements the douyin-interact command, leaving the bundle relationship implicit. | 4 / 5 |
Total | 18 / 20 Passed |