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.
An exemplary skill body for a simple tool: copy-paste-ready commands, accurate CLI documentation, a concrete output schema, and clean section organization. The only flaw is minor repetition of the no-cookies claim across three sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — commands, a CLI table, an output schema, and a cost note with no explanations of concepts Claude already knows. Not 5 because "no LinkedIn cookies required" is stated three times (intro, How It Works, Cost) and the actor name is repeated, which is minor padding that could be trimmed. | 4 / 5 |
Actionability | Quick Start gives fully executable copy-paste commands covering single post, multiple posts, max-comments, all three output formats, and dedup; the CLI table and output schema are concrete and match the actual script's flags. Fully executable and covers the common cases. | 5 / 5 |
Workflow Clarity | This is a simple single-purpose skill and the single action (run the script with --post-url) is unambiguous, with a clear 5-step How It Works sequence. The operation is read-only extraction, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Well-organized sections with the one bundle file (scripts/extract_commenters.py) correctly referenced and verified to exist with matching flags; at this size no external reference files are needed, satisfying the simple-skill exception. | 5 / 5 |
Total | 19 / 20 Passed |