zotio

zotio is a skill for Claude Code from OrgMentem/zotio. It costs 142 tokens per session (8,830 once invoked), scanned A, original, MIT.

A command-line tool for automating a Zotero library. Zotero is an application for collecting and organising research papers, references, PDFs, and annotations.

In plain words
What is it for?
Use it to search Zotero, create health reports, import papers from PDFs or DOIs, export annotations, and sync a vault.
Why use it?
It makes library searches and changes scriptable, with checks and previews that help catch problems before writing changes. It can also connect research notes with tools such as Obsidian or Logseq.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: built for openclaw.

Good fit Use it to search Zotero, create health reports, import papers from PDFs or DOIs, export annotations, and sync a vault.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/orgmentem/zotio/zotio
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add OrgMentem/zotio --skill zotio
Clone the repo
git clone --depth 1 https://github.com/OrgMentem/zotio

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for zotio

README.md
[![agentmods](https://agentmods.dev/badge/skills/orgmentem/zotio/zotio/github.svg)](https://agentmods.dev/skills/orgmentem/zotio/zotio)
Your own site
<a href="https://agentmods.dev/skills/orgmentem/zotio/zotio"><img src="https://agentmods.dev/badge/skills/orgmentem/zotio/zotio/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for zotio

Your own site · 80×15
<a href="https://agentmods.dev/skills/orgmentem/zotio/zotio"><img src="https://agentmods.dev/badge/skills/orgmentem/zotio/zotio.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 142 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 8,830 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00142 $0.08830
Opus 5.5 $0.00057 $0.03532
Sonnet 5.5 $0.00028 $0.01766
Haiku 4.5 $0.00014 $0.00883

Measured 7d ago against content hash 80b46673a2bc, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

zotio scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/gen_server_json.py, scripts/mcpb_pack.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

SKILL.md · 329 lines

How it starts

The opening of the file, as written. The whole thing — 329 lines — stays where its author put it; the contents beside it link to each section on GitHub.

zotio — Zotero automation CLI

Full command tree: ask the CLI at runtime — zotio --help, zotio <command> --help, or zotio agent-context --pretty. Installation, auth, and longer usage live in README.md and the docs site.

Prerequisites: Install the CLI

This skill drives the zotio binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

  1. Install via Homebrew (macOS / Linux):
    brew install orgmentem/tap/zotio
    
    Or download an archive from the releases page and put the binary on your $PATH — the binaries are unsigned, but checksums.txt is Sigstore-signed (checksums.txt.sigstore.json), so verify the archive against it.
  2. Verify: zotio version
  3. From source: go build -o zotio ./cmd/zotio, then put the binary on your $PATH.

If zotio version reports "command not found" after install, the install step did not put the binary on $PATH. Do not proceed with skill commands until verification succeeds.

This CLI connects directly to your running Zotero desktop app — reads need no API key. Writes (items create/update/delete/enrich, import apply, vault push) generally require a Zotero Web API key, configured once via auth set-token --stdin; personal-library creates can instead go through the keyless desktop connector. Commands that change your library or vault are preview-first: each one plans by default and applies only under --yes. Commands that touch only local state differ: auth logout and profile delete also preview by default and apply under --yes, while auth set-token and profile save apply directly. --yes is the user's decision, not yours — an agent previews, reports, and waits. Runs applied through the mutation envelope are recorded to the journal, but vault writes bypass it, and journal undo reverses only losslessly invertible ops (tag and collection-membership changes, an items new or import apply create, and items enrich DOI, abstract, citation-field, subject-tag, and MeSH-tag writes) and refuses the rest — so a journal entry is an audit record rather than a guarantee of reversibility. See write safety. It syncs your library to a local SQLite store for offline search and compound queries.

Read the full file on GitHub · 329 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago Changed · +6 lines 80b46673a2bc
  2. 10d ago Changed 07d0e38db9a4
  3. 17d ago Changed · +1 lines 18dcb0a204bc
  4. 28d ago Changed · +3 lines f07651407720
  5. 1mo ago Changed 564d633b4d2a
  6. 1mo ago Changed · +4 lines bc6dd1e3abe9
  7. 1mo ago First seen · 315 lines · 142 tokens per session scan A 0f7a80c2ff55

Subscribe to this mod's changes

zotio is a skill published in the GitHub repository OrgMentem/zotio (3 stars, last pushed 4d ago), licensed MIT. It adds 142 tokens to every session and 8,830 once invoked, about $0.0006 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

zotkit

Use when the user wants to add, create, upload/attach, download/fetch, search, tag, look up by item key, export BibTeX for, or organize references (papers, PDFs) in their Zotero library via the zotkit CLI — headless Zotero management through the Web API + WebDAV, no desktop app. Covers task recipes and safety rules.…

oldantique/zotkit · 93 tokens

zotero-cli

Read and write a Zotero library from the shell with the zotero-cli command - search papers by keyword or meaning, read PDF full text and page ranges, get and set metadata, manage collections, tags, notes and annotations, add items by DOI/URL/ISBN, and export bibliographies. Use whenever the user asks about their…

54yyyu/zotero-mcp · 93 tokens

annotate-paper

Read the open paper and write study annotations into its PDF with zotero-cli - a context box on the title, a four-part summary on the abstract, role-coded abstract highlights, one box per figure panel with a teaching comment, colour-coded body highlights, and a reading note. Use when asked to "annotate", "read and…

54yyyu/zotero-mcp · 82 tokens

library-upkeep

Add papers to the user's Zotero library and keep it tidy. Import by DOI, arXiv id, ISBN, PMID, URL, or a BibTeX or RIS file, attach open-access PDFs, find and merge duplicates, tag, file into collections, edit metadata, highlight PDF passages, and trash or restore items. Use when the user asks to save, import…

oscardvs/zoteus · 96 tokens

grounded-answers

Answer questions from the user's Zotero library with verbatim quotations and page numbers from their own PDFs. Use when the user asks what a saved paper says, where a claim comes from, what they highlighted or noted, whether something is in their library, or wants a passage, figure or table from a PDF in Zotero.

oscardvs/zoteus · 70 tokens

paper-fulltext-harvest

Batch download academic paper full-text (PDF/XML) from a list of DOIs. Handles 25 DOI prefixes across 19 publisher families via three layered routes: (1) publisher TDM APIs requiring institutional subscription (Elsevier ScienceDirect, Wiley Online, Springer Nature), (2) Open Access sources (Crossref, Unpaywall…

jxtse/scientific-research-skills · 276 tokens