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 body is well-sectioned and gives mostly executable curl guidance, but it inlines a large API parameter reference that should live in a separate file and ships two broken curl examples for its primary capabilities. Fixing the malformed examples and splitting out the reference would materially raise the score.
Suggestions
Fix the Tavily Search and Tavily Crawl curl blocks so all JSON fields sit inside the `-d` quoted body string, matching the working Extract/Map/Research examples.
Move the per-endpoint parameter tables into a references/ file (e.g. ENDPOINTS.md) and link to it from each section, keeping only one worked example inline.
Add an explicit research-task workflow (create task → poll /research/{request_id} until complete → read report) with a validation/check-status checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient API-oriented prose, but ~120 lines of per-endpoint parameter reference are inlined and the chunks_per_source description is repeated verbatim across Search, Extract, and Crawl sections, adding avoidable tokens. | 3 / 5 |
Actionability | Concrete curl examples are provided per endpoint, but the Tavily Search and Tavily Crawl examples are malformed — the JSON body fields dangle outside the `-d` quoted string — so two primary examples are not copy-paste executable. | 3 / 5 |
Workflow Clarity | Setup steps are sequenced and the async research create→poll-status pattern is implied, but there are no explicit validation checkpoints (e.g. verifying credentials, polling guidance for research tasks) and the multi-step research flow is not spelled out. | 3 / 5 |
Progressive Disclosure | The body is sectioned by capability, but the bulk of API parameter reference that belongs in a separate file is inlined into SKILL.md; no local reference bundle files exist, though the "Discover More" section points to live discovery endpoints. | 3 / 5 |
Total | 12 / 20 Passed |