Content
82%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 highly actionable, well-structured CLI reference with copy-paste commands and clear auth-safety guidance. The main weakness is length and repetition between the quick-reference table and the detailed command sections.
Suggestions
Collapse the per-section Command Details examples that merely repeat the Quick Reference table, keeping only entries that add new flags or workflows.
Move the large command table and/or raw API reference into a separate reference file, leaving SKILL.md as a concise overview with one-level-deep pointers.
Add an explicit validate→fix→retry loop for destructive or batch operations (e.g., media upload failures, rate-limit 429 handling) to strengthen workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely efficient and command-focused assuming Claude's competence, but the ~430-line body repeats commands across the Quick Reference table and per-section examples, and the Notes section adds some explanatory padding that could be trimmed. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready bash commands with real flags cover common cases (posting, media upload workflow, raw API access, multi-app switching) without pseudocode. | 5 / 5 |
Workflow Clarity | Multi-step workflows are numbered (upload→copy media_id→post; search→like→reply) with validation cues ("Run xurl auth status to check", media status --wait), but lacks an explicit validate→fix→retry error-recovery loop. | 4 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections with no nested references, but it is a single monolithic ~430-line reference that could split the bulk command/API detail into a separate file for easier navigation. | 4 / 5 |
Total | 17 / 20 Passed |