Content
67%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 compact, mostly actionable API guide with a genuinely useful credentials fallback step and sensible deferral of full endpoint details to discovery commands. Its main defects are a malformed primary search example (parameters stranded outside the request body) and light redundancy (duplicated endpoint descriptions, a generic Use Cases section) that cost both actionability and conciseness.
Suggestions
Fix the /search example so the parameters sit inside a quoted "body" object, mirroring the fetch example: -d '{"api":"linkup","path":"/search","body":{"q":"latest AI developments 2024","depth":"standard","outputType":"sourcedAnswer"}}'.
Remove the duplicated endpoint descriptions (Capabilities vs. Usage) and the generic Use Cases section, which explains nothing Claude doesn't already know.
Add a brief note on handling API errors (e.g., checking the HTTP status or error field in the response and retrying/falling back) to strengthen the feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean parameter tables and curl commands with little concept explanation, but there is trimmable redundancy: "Search the web and fetch content from any URL" restates the description, the /search and /fetch endpoint purpose sentences appear twice (Capabilities and Usage), and the generic "Use Cases" section (e.g. "Research: Search for information on any topic") tells Claude what it already knows. This fits 'efficient; minor instances of over-explanation that could be trimmed', below 5 where every token earns its place. | 4 / 5 |
Actionability | The fetch example is fully executable and the parameter documentation is concrete, but the primary /search curl example is malformed: the JSON payload closes after '{"api":"linkup","path":"search"}' and the q/depth/outputType fields dangle outside the quoted body with no 'body' wrapper, so it fails if copied verbatim. This lands at 'some concrete guidance but incomplete; missing key details' rather than 4, where the example would be executable with only minor gaps. | 3 / 5 |
Workflow Clarity | For this simple two-endpoint skill the sequence is clear: read credentials (with an explicit error-recovery fallback — "If ~/.gooseworks/credentials.json does not exist, tell the user to run npx gooseworks login"), then call /search or /fetch with documented parameters. Neither operation is destructive or batch, so the validation cap does not apply. It is below 5 only because the broken search example muddies the main workflow and there is no guidance on interpreting/handling API error responses. | 4 / 5 |
Progressive Disclosure | With no bundle files present, the single SKILL.md is well-organized into Setup, Capabilities, Usage (per endpoint), and Discover More, and the "Discover More" section appropriately defers full API details to live discovery commands rather than inlining them. It is below 5 because the ~25-line inline parameter reference sits between the two and the endpoint purpose sentences are duplicated rather than consolidated, leaving minor organization gaps. | 4 / 5 |
Total | 15 / 20 Passed |