Content
50%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.
The skill has a clear stepwise structure and concrete commands, but multiple curl examples contain broken JSON that makes them non-executable as written, the pipeline section duplicates the workflow, and batch operations lack any validation or error-recovery checkpoints. All dimensions score at the midpoint.
Suggestions
Fix the malformed curl commands: move "query", "searchParams", and "lead" payloads inside the -d JSON string (Steps 1, 2, 4), remove the stray text after -d in "Discover More", and correct the stray backtick in the olostep example.
Remove the duplicated "Prospecting Pipeline" section or replace it with a one-line pointer to the Workflow steps, cutting roughly 40 lines of repeated commands.
Add validation checkpoints for the batch workflow: check API responses for errors, handle empty search results, and require verified-email status before a contact is added to a sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean, command-first text with no padding or basic-concept explanations, but the "Prospecting Pipeline" section duplicates Steps 1-4 of the Workflow and the "Discover More" section is cluttered. It is not a 4 because the duplication is a clear instance of content that could be cut, and not a 2 because there is no conceptual over-explanation. | 3 / 5 |
Actionability | Concrete curl commands appear throughout, but several are malformed and would fail if copy-pasted: Steps 1, 2, and 4 place payload keys ("query", "searchParams", "lead") outside the closed -d JSON string, and the final example has a stray backtick in "/v1/scrapes`". It is not a 4 because broken JSON in multiple commands is more than a minor gap, and not a 2 because most commands (Steps 3, 5, 6, setup) are complete and executable. | 3 / 5 |
Workflow Clarity | Steps 1-6 are clearly sequenced (define companies → find people → get emails → verify → enrich), but the batch list-building workflow has no error handling: no checking of API responses, no guidance on empty results or failed verification, no retry loop. The batch-operation cap of 3 applies; it is not a 2 because the sequence itself is well defined and includes a verification step. | 3 / 5 |
Progressive Disclosure | No bundle files exist, and the single SKILL.md inlines endpoint reference material plus a duplicated pipeline that would fit better in a separate reference file. Section headers do provide real structure, so it is not a 2, but content that should be separate is inline, so it is not a 4. | 3 / 5 |
Total | 12 / 20 Passed |