Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with concrete curl commands and parameter tables and a clear setup sequence, but it is token-heavy due to a redundant Capabilities list, duplicate section headers, repeated auth boilerplate, and a monolithic inline structure with no progressive disclosure.
Suggestions
Remove the 'Capabilities' bullet list (it duplicates the per-endpoint descriptions that follow) and de-duplicate the repeated section headers by qualifying names, e.g., 'Market Price (Polymarket)' vs 'Market Price (Kalshi)'.
Extract the per-endpoint reference into a separate references file (e.g., ENDPOINTS.md) and keep SKILL.md as a concise overview with one-level-deep links, reducing repeated auth-header boilerplate to a single shared snippet.
Define the auth/setup block once and reference it rather than repeating the full curl header set in every endpoint example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean (parameter tables and curl examples, no concept explanations Claude already knows), but it carries real redundancy: the 'Capabilities' bullet list restates every endpoint description that follows, several section headers are duplicated (e.g., 'Market Price', 'Orderbook History', 'Trade History', 'Markets'), and the same auth-header boilerplate repeats across ~18 curl blocks. | 2 / 3 |
Actionability | Each endpoint has a concrete, copy-paste-ready curl POST with the real path and a representative query, plus a typed parameter table — fully executable guidance rather than abstract description. | 3 / 3 |
Workflow Clarity | Setup is clearly sequenced (read credentials, export env vars, fallback 'npx gooseworks login' if the file is missing) and the endpoints are simple read-only fetches, so the single action is unambiguous; no destructive/batch validation cap applies. | 3 / 3 |
Progressive Disclosure | There are no bundle files and the entire API catalog lives inline in one ~340-line SKILL.md with no file-level references; it has section structure but content that could be split into a separate reference is all inline, so organization could be better. | 2 / 3 |
Total | 10 / 12 Passed |