zotero-library-curator
Skill68 starsChanged 7 months agoMITView on GitHub
Audit and curate a Zotero library — find duplicate DOIs, orphan items missing required tags, propose collection rebinds, identify bloated or under-used collections, generate tag hygiene reports, emit preview-only cleanup plans. Use when the user asks to "audit Zotero", "find duplicates", "tag hygiene report", "which collections are bloated or under-used", or "propose a Zotero cleanup plan". Defers all CRUD operations to the standalone `zotero-skills` skill or `research-hub zotero` CLI. Includes a backup-first reminder before any apply/CRUD handoff suggestion.
- Installs packages
In this repository14 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- research-hubSkill
- gap-to-topicSkill
- literature-triage-matrixSkill
- notebooklm-brief-verifierSkill
- paper-memory-builderSkill
- paper-summarizeSkill
- research-context-compressorSkill
- research-design-helperSkill
- research-hub-multi-aiSkill
- research-hubSkill
- research-project-orienterSkill
- research-workflow-orchestratorSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 9 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 31
Before running, verify at least one runtime is present.
- Distinctive: line 44
If neither is available, stop and explain the available setup paths.
- Distinctive: line 47
Claude Code: use the canonical marketplace installation:
- Distinctive: line 54
Other hosts (including Hermes): follow the host's supported loader against the canonical upstream repository.
- Very specific: line 58
Do not clone the whole repository into a host's one-level skill directory and assume discovery, or use an obsolete root-level raw SKILL.md …
- Very specific: line 60
Or use the research-hub CLI (pip install research-hub-pipeline).
- Distinctive: line 62
After authorized setup, verify read-only connectivity: Zotero desktop's local API on port 23119, or configured Zotero Web API read access.
- Distinctive: line 114
Always emit a preview plan, never apply.
- Distinctive: line 130
If the report has 0 issues, emit a single OK line and stop.
- Distinctive: line 134
Read the dedup index first.
- Distinctive: line 138
Don't quote item titles back if a DOI / Zotero key is enough.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
zotero-library-curator
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:
- The standalone
zotero-skillsskill (full CRUD, dual local/web API routing); or - The
research-hub zoteroCLI (backfill --tags --notes [--apply], etc., which is preview-first by default).
Prerequisite check (do this first)
Reading the Zotero library requires a connection. The skill works in two modes:
- Read-only audit / preview — needs either
zotero-skills(Zotero local API) or theresearch-hub zoteroCLI to inspect items. - Apply cleanup — must defer to
zotero-skillsorresearch-hub zotero ... --apply.
Before running, verify at least one runtime is present. Loading a skill's instructions alone does not establish Zotero connectivity.
research-hub doctor 2>/dev/null # if research-hub CLI installedFor zotero-skills, use the host's plugin/skill discovery to resolve the
installed plugin root or upstream checkout. The canonical entry point is
skills/zotero-skills/SKILL.md relative to that root, not root-level
SKILL.md. Keep root-level scripts/ and the skill's references/
available; a raw SKILL.md-only install is not a complete runtime.
If neither is available, stop and explain the available setup paths; do not install anything merely because an audit was requested:
Claude Code: use the canonical marketplace installation:
claude plugin marketplace add WenyuChiou/ai-research-skills claude plugin install zotero-skills@ai-research-skills --scope user- Other hosts (including Hermes): follow the host's supported loader
against the canonical upstream repository.
Load
skills/zotero-skills/SKILL.mdfrom the resolved checkout, retainingscripts/at the repository root andreferences/beside the skill. Do not clone the whole repository into a host's one-level skill directory and assume discovery, or use an obsolete root-level raw SKILL.md URL. - Or use the
research-hubCLI (pip install research-hub-pipeline).
After authorized setup, verify read-only connectivity: Zotero desktop's
local API on port 23119, or configured Zotero Web API read access. An audit
does not authorize writes, installing dependencies, changing credentials,
or granting persistent access. Never print API keys or inspect credential
files; if credential diagnosis is necessary, use the upstream
credentials_status() helper's presence/source labels only. Ask the user
to handle credential or permission changes. Re-run the audit only when a
read-capable runtime is available.
When to use
Trigger phrases:
- "Audit my Zotero library."
- "Find duplicate DOIs in Zotero."
- "Find Zotero items missing required tags."
- "Propose a tag hygiene cleanup plan."
- "Generate a Zotero cleanup preview before I apply anything."
- "Which Zotero collections are bloated / under-used?"
Not for:
- Adding, editing, or deleting items — defer to
zotero-skillsskill. - Backfilling tags/notes on items already in research-hub clusters —
use
research-hub zotero backfill(already preview-first). - Cluster-level operations — use
research-hub clusterscommands. - Searching the library for a specific paper — use
zotero-skillssearch, not the curator.
Inputs
In priority order:
- research-hub cluster registry (
.research_hub/clusters.yaml) — to know which Zotero collections belong to which research clusters. - Zotero library state via local API (fast, read-only) — list
items, list collections, list tags. Use
zotero-skillsREAD Operationspatterns directly; don't reinvent. - research-hub dedup index (
.research_hub/dedup_index.json) — precomputed DOI/title hash table; far cheaper than a fresh scan. - Optional: backfill report from
research-hub zotero backfill(saved to.research_hub/backfill-*.md) — historical state of prior cleanups.
Audit checks
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.
Output discipline
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.
Token-saving behavior
- Read the dedup index first; only hit the Zotero local API for items not in the index.
- Cap full-library scans at 100 items per audit run unless the user explicitly says "full library".
- Don't quote item titles back if a DOI / Zotero key is enough.
- Cache the report in
.research_hub/curator-<timestamp>.mdif the user asks "save this report".
What NOT to do
- Do NOT call any Zotero create / update / delete endpoint. That's
zotero-skills' or research-hub's job, with explicit user
--apply. - Do NOT rename tags directly — propose, then defer to manual
review or
zotero-skillsbatch update. - Do NOT trash duplicate items automatically — propose, then defer
to
research-hub zotero backfill --applyor manual delete. - Do NOT redocument the zotero-skills CRUD primitives — link to them. The whole point of this skill is to be the layer above.
See also
references/audit-checks.md— full details for each of the 5 audit checksreferences/report-template.md— full curation-report preview template
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

