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.
77
67%
Does it follow best practices?
Impact
97%
1.56xAverage score across 3 eval scenarios
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/protocolsio-integration/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly identifies the platform (protocols.io), lists specific capabilities (search, create, update, publish, manage steps/materials, handle discussions, organize workspaces, upload files), and provides explicit trigger guidance for when to use it. The description covers both the 'what' and 'when' thoroughly, and the domain-specific terminology makes it highly distinctive from other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: search, create, update, publish protocols; manage protocol steps and materials; handle discussions and comments; organize workspaces; upload and manage files. These are clearly defined capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (integration with protocols.io API for managing scientific protocols, with specific actions listed) and 'when' ('should be used when working with protocols.io to search, create, update...' and 'Applicable for protocol discovery, collaborative protocol development...'). Explicit trigger guidance is present. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'protocols.io', 'scientific protocols', 'protocol steps', 'materials', 'workspaces', 'lab protocol management', 'experiment tracking', 'scientific documentation', 'collaborative protocol development'. Good coverage of domain-specific terms. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive due to the specific platform (protocols.io) and domain (scientific protocols, lab protocol management). Very unlikely to conflict with other skills given the narrow, well-defined niche. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is well-structured in its reference architecture and provides some useful executable Python examples, but it is significantly over-verbose. It spends too many tokens on descriptive catalogs of capabilities, generic best practices Claude already knows, and high-level workflow descriptions that lack validation checkpoints. The content would be far more effective at roughly one-third its current length, focusing on the code examples, base URL/auth format, and concise workflow steps with validation.
Suggestions
Cut the 'When to Use This Skill' section entirely and reduce 'Core Capabilities' to a simple table mapping task → reference file, eliminating the 'Key operations' bullet lists that duplicate reference file content.
Remove the 'Best Practices', 'Additional Resources', and 'Troubleshooting' sections — these contain generic advice Claude already knows and add ~60 lines of low-value content.
Add explicit validation checkpoints to workflows, e.g., after creating a protocol, verify the response contains the expected ID; after publishing, confirm DOI was issued; after file upload, verify file appears in workspace listing.
Consolidate the Getting Started section with the Common Workflows section to avoid redundancy in authentication setup instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~300+ lines. The 'When to Use This Skill' section lists 10 bullet points that are obvious from context. 'Core Capabilities' repeats information that's already in reference files. Sections like 'Best Practices' contain generic advice Claude already knows (e.g., 'store tokens securely', 'handle all HTTP error codes'). The 'Additional Resources' and 'Troubleshooting' sections add little unique value. Much of this content is descriptive rather than instructive. | 1 / 3 |
Actionability | The Python code examples are concrete and mostly executable, which is good. However, much of the skill is descriptive catalog-style content ('Key operations' bullet lists) rather than actionable instructions. The workflows describe steps at a high level without complete executable examples. The code examples cover basic cases but the bulk of the document describes rather than instructs. | 2 / 3 |
Workflow Clarity | Five workflows are clearly sequenced with numbered steps and reference file pointers, which is helpful. However, none include explicit validation checkpoints or error recovery feedback loops. For example, 'Create and Publish Protocol' workflow has a 'Review: Verify all content is complete' step but no concrete validation mechanism. The 'Experiment Documentation' workflow involves data upload but lacks verification steps. | 2 / 3 |
Progressive Disclosure | The skill references six separate reference files with clear navigation pointers, which is good structure. However, no bundle files were provided, so we cannot verify these references exist. The main SKILL.md itself is bloated with content that should either be in reference files or omitted entirely — the 'Core Capabilities' section essentially duplicates what the reference files should contain. The 'When to Use This Skill' and 'Best Practices' sections are inline content that adds bulk without value. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
Total | 10 / 11 Passed | |
cbcae7b
Table of Contents
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.