Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exemplary concise, actionable skill body: executable Quick Start, complete CLI reference, real bundled script, and tidy sections with no fluff. The single-task workflow is unambiguous and the script provides internal error/cost feedback, so no improvement is needed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — a Quick Start with three copy-paste commands, a compact CLI flag table, a one-line cost note, and a short Notes list — with no padding or explanations of concepts Claude already knows, matching the 'lean and efficient; every token earns its place' anchor. | 3 / 3 |
Actionability | It provides fully executable commands (real script path, real flags, real example URLs), a complete CLI reference table with defaults, and a referenced script (scripts/scrape_linkedin_posts.py) that exists and is runnable, matching the 'fully executable code/commands; copy-paste ready' anchor. | 3 / 3 |
Workflow Clarity | This is a simple single-action skill (invoke one script); per the simple-skills carve-out, workflow clarity scores 3 when the single action is unambiguous, and the script itself handles polling, FAILED/ABORTED/TIMED-OUT states, timeouts, and prints a cost estimate before running, providing internal validation rather than leaving the operator without feedback. | 3 / 3 |
Progressive Disclosure | The body is under 50 lines with no need for external references, organized into clear sections (Quick Start, CLI Reference, Cost, Notes); the only bundle file (scripts/scrape_linkedin_posts.py) is referenced by an accurate path and exists, satisfying the 'well-organized sections' criterion for simple skills. | 3 / 3 |
Total | 12 / 12 Passed |