Content
93%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.
An exemplary command-catalog skill: lean, fully executable, accurately mirroring the real scripts in the bundle, and cleanly organized by endpoint category. The only gaps are workflow niceties — no troubleshooting path for a failed Quick Check and no mention of pagination via --cursor.
Suggestions
Add one line after the Quick Check describing what to do on failure (e.g., missing TWITTERAPI_API_KEY or a dependency error) to close the feedback loop.
Document the --cursor pagination flag shown by the scripts (e.g., how to continue a truncated result set from the cursor printed by print_pagination).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely executable commands with placeholder arguments and one-line notes (e.g., "# Worldwide"), with zero explanation of concepts Claude already knows — no "what is Twitter" or "how APIs work" padding. Every section (Prerequisites, Commands, Search Query Syntax, API) earns its tokens, matching 'Lean and efficient; every token earns its place'. | 5 / 5 |
Actionability | Every command is fully executable as written (e.g., `python3 scripts/get_user_info.py elonmusk`, `python3 scripts/search_tweets.py "AI min_faves:1000"`), all 26 referenced scripts exist in scripts/ with matching argument shapes, and the Quick Check gives a copy-paste verification path. This matches the score-5 'Fully executable; copy-paste ready commands covering the common cases' anchor. | 5 / 5 |
Workflow Clarity | The sequence is clear — set API key in ~/.zshrc, run the Quick Check to validate, then run endpoint commands — and all operations are read-only so no destructive-validation cap applies. However, there is no error-recovery guidance (what to do when the Quick Check fails) and the --cursor pagination flag visible in the scripts is never explained, so it sits at 'Clear sequence with most checkpoints present; minor validation gaps' rather than the score-5 anchor requiring explicit feedback loops. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: SKILL.md is a well-organized command index grouped by endpoint category (User/Tweet/List/Community/Other), and every one-level-deep reference (scripts/*.py) is a real file reachable via the listed command. Detail lives in the scripts, nothing that belongs in a separate file is inlined, and the brief API footer (base URL, auth, pricing, docs) is appropriately placed. This matches 'Clear overview with well-signaled one-level-deep references; easy navigation'. | 5 / 5 |
Total | 19 / 20 Passed |