Content
75%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.
A highly actionable, executable API skill: complete curl/jq recipes, explicit destructive-action confirmation, and well-signaled one-level-deep references for search syntax, sharing, and highlights. Its main cost is token weight — repeated curl boilerplate and duplicated pagination/search content pad the body beyond what the information content justifies.
Suggestions
State the Authorization-header curl pattern once at the top and abbreviate subsequent examples (e.g. 'curl $AUTH ...') to cut a large fraction of the body's tokens.
Merge the 'Pagination' section into the existing 'Paginate Through All Bookmarks' pattern and the duplicated search examples into one, removing the repetition.
Add a per-response HTTP status check inside the pagination/bulk loops (or a retry note for 429 rate limiting) to close the last workflow-validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with Raindrop-specific facts Claude cannot be assumed to know (endpoint paths, system collection IDs -1/-99, field names, rate limit), which earn their tokens — but it is noticeably repetitive rather than merely trimmable: the Authorization-header curl boilerplate is repeated ~15 times across examples, and content is duplicated (the paginate-through-bookmarks loop appears both in 'Common Patterns' and again in the 'Pagination' section; the search examples and search-operator pointer appear twice). That is more than 'minor instances of over-explanation', placing it at the mostly-efficient anchor rather than the efficient one. | 3 / 5 |
Actionability | Every example is a copy-paste-ready curl command with real headers, JSON bodies, and jq pipelines, covering the common cases (list, create, search, move, tag management, pagination loop, export, duplicate check) plus a worked HTTP status-code error-handling snippet. Fully executable with only intentional placeholders (COLLECTION_ID, TARGET_COLLECTION_ID). | 5 / 5 |
Workflow Clarity | The Workflow Summary gives a clear ordered sequence (resolve token → verify with GET /user → read ops direct → confirm before writes → paginate → parse with jq), and the Confirmation Requirement section is an explicit pre-destructive checkpoint, which avoids the destructive/batch cap. The gap keeping it below the top anchor: the pagination and bulk loops never check HTTP status per response, and the workflow summary partially restates rather than adds validation (no retry/backoff guidance for 429). | 4 / 5 |
Progressive Disclosure | Bundle structure is sound: three real, clearly-signaled, one-level-deep reference files (search-operators.md, collections-sharing.md, highlights.md) are linked from the relevant sections with descriptive pointers, and each exists with substantive content. What keeps it at 4 rather than 5 is that the SKILL.md itself carries the entire endpoint reference (~550 lines) inline, including bulk tables for secondary areas (user, import, backups) that could be trimmed or split, so most content is appropriately placed but organization has minor gaps. | 4 / 5 |
Total | 16 / 20 Passed |