Content
61%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 body is efficient and well-structured with concrete API commands, but most of the substantive curl payloads are syntactically broken (truncated -d arguments), making the core workflow non-executable as written. Validation is also relegated to tips rather than explicit workflow checkpoints.
Suggestions
Fix the malformed JSON payloads: complete the -d '{...}' argument so Steps 2-3 and both Example Usage commands are valid, copy-paste-executable curl calls.
Promote verification into the workflow as an explicit step (e.g. "Step 5: Verify extracted figures against the source document before reporting") instead of a tip.
Remove the duplicated Example Usage commands or differentiate them meaningfully, and clean up the Discover More section (drop the stray `api show riveter` fragment and the broken trailing example).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by executable curl commands with almost no explanation of concepts Claude already knows, matching "efficient; minor instances that could be trimmed." It is not 5 because the line "Extract text, tables, and structured data from PDF documents" repeats the description and the Example Usage section largely duplicates Steps 2-3; not 3 because the padding is minor rather than whole unnecessary explanatory sections. | 4 / 5 |
Actionability | Commands are concrete curl calls with real endpoints, but several payloads are malformed and not executable as written — Step 2, Step 3, and both Example Usage blocks end the -d argument early (`-d '{"api":"scrapegraph","path":"/v1/smartscraper"}'` followed by unquoted stray JSON like `"website_url": ...}`), so copy-paste runs fail. This matches "some concrete guidance but incomplete; missing key details" rather than 4, since the breakage affects most of the workflow's key commands, not a minor gap. | 3 / 5 |
Workflow Clarity | Steps 1-4 are clearly sequenced under headings, but validation is only implicit — verification appears as a Tip ("Verify extracted numbers against source") rather than a workflow checkpoint, and Step 1's Linkup fetch result is never connected to the later extraction steps. This fits "steps listed but validation gaps; checkpoints missing or implicit," above 2 because the sequence itself is well defined. | 3 / 5 |
Progressive Disclosure | The body is organized into clear sections (Setup, Workflow, Example Usage, Tips, Discover More) with content appropriately inline for an API-usage skill and no bundle files to reference, matching "good structure; most content is appropriately placed; minor organization gaps." It is not 5 because the duplicated Example Usage section and the muddled Discover More section (a stray `api show riveter` fragment and a broken details example) leave minor organization gaps. | 4 / 5 |
Total | 14 / 20 Passed |