Content
72%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 with executable commands and clear section organization, but it loses some token efficiency to duplication between the Quick Reference table and Command Details, and its workflows omit validation checkpoints for destructive and batch operations.
Suggestions
Collapse the duplication between the Quick Reference table and the Command Details code blocks — keep the table as the index and have Command Details cover only non-obvious flag combinations and edge cases.
Add explicit validation/confirmation checkpoints to destructive and batch workflows, e.g. a confirm-or-preview step before 'xurl delete POST_ID' and a verify step after multi-media uploads.
Consider moving the verbatim flag reference and raw-API/streaming sections into a reference file if the bundle grows, to keep SKILL.md as a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and free of concept-overexplaining fluff, but the Quick Reference table and Command Details sections substantially overlap — nearly every command appears in both the table and again as a code block, which could be tightened. | 2 / 3 |
Actionability | Throughout the body, commands are fully executable, copy-paste ready, and include specific flags, IDs, URLs, and example bodies — matching the score-3 anchor for concrete executable guidance. | 3 / 3 |
Workflow Clarity | Multi-step workflows like post-with-media and multi-app setup are clearly sequenced, but destructive operations (e.g. delete) and batch operations lack explicit validation/feedback-loop checkpoints, which caps workflow clarity at 2. | 2 / 3 |
Progressive Disclosure | No bundle files exist, but the content is cleanly partitioned into well-labeled, one-level sections (Installation, Prerequisites, Quick Reference, Command Details, Global Flags, etc.) with easy navigation, which meets the bar for well-organized single-document skills. | 3 / 3 |
Total | 10 / 12 Passed |