CtrlK
BlogDocsLog inGet started
Tessl Logo

protocolsio-integration

Integration with protocols.io API for managing scientific protocols. This skill should be used when working with protocols.io to search, create, update, or publish protocols; manage protocol steps and materials; handle discussions and comments; organize workspaces; upload and manage files; or integrate protocols.io functionality into workflows. Applicable for protocol discovery, collaborative protocol development, experiment tracking, lab protocol management, and scientific documentation.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is protocolsio-integration in K-Dense-AI/scientific-agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

The body delivers solid, executable API guidance with well-structured, verified one-level-deep references and clearly sequenced workflows. Its main weaknesses are redundancy (reference routing repeated three times, generic best-practices/troubleshooting filler) and mostly implicit rather than explicit response-validation checkpoints in the workflows.

Suggestions

Consolidate the three repeated reference-routing sections (per-capability 'Reference:' lines, 'Getting Started Step 2', and the 'Reference Files' section) into a single routing table to cut significant duplication.

Remove or shrink the generic 'Best Practices' and 'Troubleshooting' lists, keeping only protocols.io-specific advice (e.g., PDF endpoint's 5 req/min limit, CLIENT vs OAUTH token choice) that Claude wouldn't already know.

Add explicit validation checkpoints to the create/publish workflows — e.g., check the HTTP status and returned protocol_id after 'POST /protocols' before proceeding to add steps or issuing the DOI.

DimensionReasoningScore

Conciseness

The body is mostly purposeful (endpoints, rate limits, content_format options, workflows) but carries several padded sections: the reference routing is repeated three times (per-capability 'Reference:' lines, 'Getting Started Step 2', and the terminal 'Reference Files' section), and generic filler like the ten-item 'Best Practices' list ('Store tokens securely', 'Document protocol steps thoroughly') and boilerplate retry code teaches Claude things it already knows. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' better than the anchor below it, since the padding is a minority of the content.

3 / 5

Actionability

Concrete, executable guidance throughout: exact endpoints ('POST /protocols/{id}/publish', 'GET /protocols'), the base URL 'https://protocols.io/api/v3', auth header format, and three copy-paste-ready Python examples (search, create, upload) plus a retry function. Minor gaps keep it below 5 — workflows like step creation and DOI publishing reference endpoints without code examples, and response-shape handling is inconsistent ("items" vs "item").

4 / 5

Workflow Clarity

Five workflows give clear numbered sequences naming specific endpoints and the reference files to consult, and the publish workflow includes a 'Review: Verify all content is complete and accurate' checkpoint. It sits below 5 because validation is mostly soft (no checking of API responses/status codes after create or publish steps), matching 'clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

The bundle structure is genuinely one level deep: all six 'references/*.md' files exist, each capability area signals exactly which file to read, and the 'Getting Started' routing table makes navigation easy. It falls short of 5 because SKILL.md itself is a fairly long detailed page (~420 lines) with inline code examples, rate limits, and troubleshooting that partially duplicate what the reference files cover — 'most content is appropriately placed; references mostly clear; minor organization gaps'.

4 / 5

Total

15

/

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: it pairs a concrete third-person capability inventory with an explicit 'should be used when' trigger clause and domain-distinctive keywords. The only minor gap is a few missing natural synonyms (e.g., citation/DOI phrasing) in the trigger vocabulary.

DimensionReasoningScore

Specificity

The description lists many concrete actions — 'search, create, update, or publish protocols; manage protocol steps and materials; handle discussions and comments; organize workspaces; upload and manage files' — giving comprehensive coverage in third-person voice. It matches the anchor for multiple specific concrete actions; a score of 4 would require noticeable gaps in coverage, which are not present.

5 / 5

Completeness

It explicitly answers both what ('Integration with protocols.io API for managing scientific protocols') and when ('This skill should be used when working with protocols.io to...'), with concrete trigger phrases enumerated. This matches the top anchor; a 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'protocols.io', 'search, create, update, or publish protocols', 'protocol discovery', 'experiment tracking', 'lab protocol management', 'scientific documentation' — phrases a user would naturally say. A few natural synonyms are missing (e.g., 'cite protocols'/'DOI', 'protocol steps' variants), so it falls just below the comprehensive-with-synonyms anchor of 5 but clearly above the midpoint.

4 / 5

Distinctiveness Conflict Risk

The protocols.io platform name and domain-specific triggers (protocol publishing, DOI-adjacent lab workflows, workspaces for protocols) establish a clear niche with minimal overlap risk against generic document- or file-management skills. It clearly fits the 'clear niche with distinct triggers' anchor.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
synthetic-sciences/openscience
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.