Content
92%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.
This is a strong skill body: fully executable commands verified against the bundled script, a numbered operational procedure with pre-flight validation and error-recovery paths, and pitfall guidance restricted to non-obvious, environment-specific facts. The only weakness is mild redundancy — the Prerequisites table and repeated rate-limit commentary could be trimmed without losing information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with Reddit- and environment-specific facts Claude cannot know (403s from datacentre IPs, feed throttling, client_credentials grant) and avoids generic concept explanations. Minor trimming is possible: the Prerequisites comparison table restates the adjacent prose (rate limit, thread data, "Acts as a user | no"), and rate-limit guidance recurs across Prerequisites, Procedure ②, and Pitfalls, so it sits at anchor 4 rather than a fully lean 5. | 4 / 5 |
Actionability | Every operation ships as a copy-paste-ready command with real arguments ("python3 scripts/reddit.py sub LocalLLaMA --sort hot --limit 15", "search ... --sub NAME", "thread URL --limit 40", "user spez", "--json"), the Quick Reference table maps each need to its command and flags, and the Verification section gives exact commands with expected outputs ("anonymous_feed: ok", "active_backend: oauth"). All commands match the bundled script's argparse. This matches anchor 5. | 5 / 5 |
Workflow Clarity | The Procedure is a clearly numbered sequence (① doctor → ② plan calls against the rate budget → ③ read thread bodies → ④ cite permalinks → ⑤ escalate to app credentials for sustained use) with an explicit pre-flight validation checkpoint (①) and error-recovery guidance (429 → script waits and retries once; more than one 429 means credentials are needed). The separate Verification section supplies concrete expected outputs, satisfying anchor 5's explicit-validation and feedback-loop bar; the skill is read-only, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | The bundle is a single script (scripts/reddit.py), which the body references by the correct relative path and whose commands/flags match the actual argparse implementation. At ~115 lines the SKILL.md is an appropriately sized overview (when to use, prerequisites, commands, procedure, pitfalls, verification) with implementation detail correctly pushed into the script, and all sections are well-signaled and flat — matching the simple-skill exception for well-organized content with no nested references. | 5 / 5 |
Total | 19 / 20 Passed |