From research-workspace
Audits Zotero libraries for duplicates, orphan items, bloated collections, and tag issues; emits preview-only cleanup plans. Defers CRUD to zotero-skills skill or research-hub CLI.
How this skill is triggered — by the user, by Claude, or both
Slash command
/research-workspace:zotero-library-curatorThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Sit one layer above the standalone `zotero-skills` skill. This skill
Sit one layer above the standalone zotero-skills skill. This skill
reads the Zotero library, runs audit + hygiene checks, and emits
preview plans. It does NOT perform the changes itself.
For any actual create / update / delete operation, defer to:
zotero-skills skill (full CRUD, dual local/web API
routing); orresearch-hub zotero CLI (backfill --tags --notes [--apply],
etc., which is preview-first by default).Reading the Zotero library requires a connection. The skill works in two modes:
zotero-skills
(Zotero local API) or the research-hub zotero CLI to
inspect items.zotero-skills or
research-hub zotero ... --apply.Before running, verify at least one is present. The zotero-skills check is host-dependent — adapt to your agent's skills directory:
research-hub doctor 2>/dev/null # if research-hub CLI installed
# Check whether the zotero-skills sibling skill is installed.
# Claude Code: ls ~/.claude/skills/zotero-skills/SKILL.md
# Hermes: ls ~/.hermes/skills/research/zotero-skills/SKILL.md
# Other hosts: ls <host-skills-dir>/zotero-skills/SKILL.md
If neither is available, the host has loaded these instructions but
has no Zotero-capable runtime (research-hub CLI or standalone
zotero-skills). Stop and tell them:
This skill audits a Zotero library, which needs Zotero connectivity via one of:
- The standalone
zotero-skillsskill (handles Zotero local API). Install via your host's skill installer (e.g. on Claude Code,git clone https://github.com/WenyuChiou/zotero-skills ~/.claude/skills/zotero-skills; on Hermes,hermes skills install https://raw.githubusercontent.com/WenyuChiou/zotero-skills/master/SKILL.md).- Or the
research-hubCLI:pip install research-hub-pipelineEither path needs Zotero configured (local API on port 23119, or Zotero Web API key). Once one is set up, re-run your audit request.
Trigger phrases:
Not for:
zotero-skills skill.research-hub zotero backfill (already preview-first).research-hub clusters commands.zotero-skills
search, not the curator.In priority order:
.research_hub/clusters.yaml) —
to know which Zotero collections belong to which research clusters.zotero-skills READ Operations patterns directly; don't reinvent..research_hub/dedup_index.json) —
precomputed DOI/title hash table; far cheaper than a fresh scan.research-hub zotero backfill
(saved to .research_hub/backfill-*.md) — historical state of
prior cleanups.Five checks: duplicate DOI scan, orphan-tag scan, cross-collection cluster mismatch, tag hygiene report, collection bloat / sparsity. Pick the relevant subset for each user request.
Full check details + suggested fixes for each: references/audit-checks.md.
Always emit a preview plan, never apply. The report has 5 sections that map 1:1 onto the audit checks (skip a section if its check returned no findings) plus a "Suggested follow-ups" section listing concrete CLI commands for the user to run.
The "Suggested follow-ups" section MUST open with a one-line backup reminder before any apply/CRUD handoff suggestion:
Back up first. In Zotero desktop: File → Export Library → Zotero RDF. Any modifications via
zotero-skillsorresearch-hub zotero ... --applyare irreversible without this snapshot.
This is required because this skill is read-only but its output
typically feeds an apply step run by zotero-skills. Surfacing the
backup step at handoff prevents the most common data-loss class
(accidental tag mass-rename or collection move with no undo).
Full report template: references/report-template.md.
If the report has 0 issues, emit a single OK line and stop.
.research_hub/curator-<timestamp>.md if the
user asks "save this report".--apply.zotero-skills batch update.research-hub zotero backfill --apply or manual delete.references/audit-checks.md — full details for each of the 5 audit checksreferences/report-template.md — full curation-report preview templatenpx claudepluginhub wenyuchiou/ai-research-skills --plugin research-workspacePerforms standalone Zotero library operations — adding abstracts, attaching PDFs, enriching metadata, deduplicating, and fixing BBT citation keys. Not for systematic review pipelines.
Manage Zotero reference libraries via the pyzotero Python client: retrieve, create, update, and delete items, collections, tags, and attachments through the Zotero Web API v3.
Manage Zotero reference libraries via Python using the pyzotero client. Retrieve, create, update, delete items, collections, tags, and attachments through the Zotero Web API v3.