Agent skill · Data & Analytics

protocolsio-integration

Read, validate, and safely export protocols.io data with current official REST/MCP contracts, or create non-executing mutation plans. The bundled client makes bounded official-host GET requests only with explicit --execute. Use only for tasks explicitly targeting protocols.io or an exact protocols.io protocol version.

K-Dense-AIgithub.com/K-Dense-AIGitHub ↗
claude-codecan modify filesships scriptsMIT
Install
npx skills add K-Dense-AI/scientific-agent-skills --skill protocolsio-integration --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 15
SKILL.md size: 11 KB
Bundled scripts: yes
Version: 1.1
Allowed tools: ReadWritePython
Requires: Bundled CLIs require Python 3.11+ and use only the standard library. Offline validation and planning need no…
Path: skills/protocolsio-integration/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 32,619
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# protocols.io Integration Use the exact endpoint version documented for each operation. The official API landing page is still titled “API v3,” but its maintained sections mix **v3** and **v4**. There is no single safe `/api/v3` base to apply to every resource. This skill was refreshed against official sources on **2026-07-23**. ## Operating Contract 1. **Start offline.** Validate credentials/configuration, saved JSON, pagination, or a write plan before making a request. 2. **Require `--execute` for network reads.** Bundled write tooling has no execution mode. 3. **Read only named variables.** Never inspect the full environment, search for `.env` files, traverse parent directories, or accept a token/secret in a command argument, request file, log, traceback, or output. 4. **Use official HTTPS hosts only.** Core reads use `www.protocols.io` (the docs also show the bare host). Organization exports use the customer's explicit `<subdomain>.protocols.io` origin. Reject redirects and disable ambient proxy discovery so bearer credentials are not routed unexpectedly. 5. **Distinguish public content from anonymous API access.** A client token is documented for public data. Most REST endpoi

What's inside
Steps it walks through
  1. Operating Contract
  2. Current API Map
  3. Authentication and Access
  4. Safe Read Workflow
  5. Pagination
  6. Offline Protocol Validation
  7. Mutation and Upload Workflow
  8. Errors and Rate Limits
  9. Official Integrations
  10. References
Ships with 14 files
  • assets/protocol-snapshot.schema.json
  • references/additional_features.md
  • references/authentication.md
  • references/discussions.md
  • references/file_manager.md
  • references/protocols_api.md
  • references/workspaces.md
  • scripts/__init__.py
  • scripts/_common.py
  • scripts/pagination_helper.py
  • scripts/plan_write_request.py
  • scripts/protocols_read.py
  • scripts/validate_auth_config.py
  • scripts/validate_protocol_json.py
Commands it runs
python3 -B scripts/validate_auth_config.py --require read
python3 -B scripts/protocols_read.py list --query "single cell RNA"
python3 -B scripts/protocols_read.py get --id "protocol-uri/v2"
python3 -B scripts/protocols_read.py export-pdf \
python3 -B scripts/protocols_read.py --execute \
list --query "single cell RNA" --page-size 10 --max-pages 2 --max-items 20
python3 -B scripts/pagination_helper.py \
python3 -B scripts/validate_protocol_json.py \
python3 -B scripts/plan_write_request.py \
More from scientific-agent-skills
All skills →
About this skill
What does the protocolsio-integration skill do?

Read, validate, and safely export protocols.io data with current official REST/MCP contracts, or create non-executing mutation plans. The bundled client makes bounded official-host GET requests only with explicit --execute. Use only for tasks explicitly targeting protocols.io or an exact protocols.io protocol version.

How do I install it?

Run `npx skills add K-Dense-AI/scientific-agent-skills --skill protocolsio-integration --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From K-Dense-AI/scientific-agent-skills, a repository with 32,619 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going