CtrlK
BlogDocsLog inGet started
Tessl Logo

raindrop-api

This skill provides comprehensive instructions for interacting with the Raindrop.io bookmarks service via its REST API using curl and jq. It covers authentication, CRUD operations for collections, raindrops (bookmarks), tags, highlights, filters, import/export, and backups. Use this skill whenever the user asks to work with their bookmarks from Raindrop.io, including reading, creating, updating, deleting, searching, or organising bookmarks and collections.

88

1.28x
Quality

83%

Does it follow best practices?

Impact

100%

1.28x

Average score across 3 eval scenarios

SecuritybySnyk

High

Do not use without reviewing

The canonical home for this skill is raindrop-api in intellectronica/agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete capability list, explicit 'Use this skill whenever...' trigger clause, and a clearly distinct named-service niche. The only weakness is slightly incomplete synonym coverage for natural user phrasing, and the unnecessary word 'comprehensive'.

Suggestions

Drop the self-assessment word 'comprehensive' — the concrete coverage list already demonstrates scope.

Add one or two natural synonyms users might say, e.g. 'managing links' or 'bookmark manager', to widen trigger coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities ("authentication, CRUD operations for collections, raindrops (bookmarks), tags, highlights, filters, import/export, and backups"; "reading, creating, updating, deleting, searching, or organising") with comprehensive coverage of the domain. The word "comprehensive" is mild self-praise but the action list itself is fully concrete, so this fits the anchor for multiple specific concrete actions rather than the level below with minor gaps.

5 / 5

Completeness

It explicitly answers both questions: what ("interacting with the Raindrop.io bookmarks service via its REST API using curl and jq", with a coverage list) and when ("Use this skill whenever the user asks to work with their bookmarks from Raindrop.io, including reading, creating, updating, deleting, searching, or organising bookmarks and collections"). This matches the top anchor with concrete trigger phrases, not the level below where 'when' is merely adequate.

5 / 5

Trigger Term Quality

Natural trigger terms are present ("work with their bookmarks from Raindrop.io", "reading, creating, updating, deleting, searching", "collections"), which a user would plausibly say. A few natural synonyms are missing — e.g., "links", "save links", or "bookmark manager" — so it falls just short of the comprehensive-with-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

"Raindrop.io" is a distinct named service with its own noun ("bookmarks", "raindrops", "collections"), giving it a clear niche with minimal chance of firing for an unrelated skill. No generic phrasing that would overlap with other skills.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (558 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
intellectronica/agent-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.