Content
81%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 body is a strong, self-contained API skill: executable commands, complete parameter and response documentation, and clear error handling with recovery guidance. Its weaknesses are redundancy — the same curl example repeated three times and a confusing duplicate <details> block pointing at a different endpoint — and one error-handling note about -q flags that is inconsistent with the POST/JSON style used everywhere else.
Suggestions
Deduplicate the curl examples: the Examples section repeats the exact command from "Basic Product Search", and the <details> curl-equivalent block duplicates it against a different endpoint (api.orth.sh) — collapse these into one canonical example with a note on the endpoint difference.
Remove or rewrite the final error-handling bullet about separate -q flags and '&' in query strings: it describes GET-style flags that conflict with the POST JSON-body pattern used throughout the skill.
Trim the Examples section to show only query variations (e.g., a table of user phrasing → q value) rather than repeating the full curl command for each case.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with no explanations of concepts Claude already knows, but the identical base curl command is repeated three times (Usage "Basic Product Search", the <details> "curl equivalent" block, and the first Example), which is unnecessary padding that could be tightened. It is not a 2 because there is no conceptual over-explanation, only duplicated examples. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready curl commands with auth headers and JSON bodies; a concrete parameter list, a documented response schema, and worked examples covering the common cases (basic search, category filter, price-constrained, rating-based). It clearly matches the anchor-5 example rather than anchor 4, which implies minor gaps in executability. | 5 / 5 |
Workflow Clarity | This is a simple single-purpose skill whose single action is unambiguous: read credentials from ~/.gooseworks/credentials.json (with a fallback instruction if missing), export env vars, run the curl call, interpret organic_results, and handle errors. The error-handling section provides feedback loops (429 wait-and-retry, empty results → try broader terms), satisfying the simple-skill exception for a 5; no destructive or batch operations are involved. | 5 / 5 |
Progressive Disclosure | Sections are well-organized (Setup, When to Use, Usage, Parameters, Response, Examples, Error Handling) with no nested references, and the content is appropriately self-contained since no bundle files exist. It falls short of 5 because the inline response-field reference and the buried, duplicative <details> block could be streamlined, and the redundant Examples section adds organization gaps. | 4 / 5 |
Total | 17 / 20 Passed |