zotero-dev-ruleslisted
Install: claude install-skill Agents365-ai/zotero-dev-rules
# Zotero Dev Rules
Zotero is an open-source reference manager. Developers extend it three ways: the **Web API**
(`https://api.zotero.org`) for online libraries, **plugins / the internal JavaScript API** for the
desktop client, and **translators** (JS scrapers/converters). Citations come from **CSL** styles via
**citeproc-js**. This skill mirrors <https://www.zotero.org/support/dev> so you can answer Zotero dev
questions and build integrations without re-fetching.
## When to use this skill
- Reading from / writing to a Zotero library over the **Web API** (items, collections, tags, searches).
- File attachment upload, full-library or partial **syncing**, **streaming** (WebSocket) updates, **OAuth**.
- Building or debugging a **Zotero 7 plugin**; scripting the client via its **JavaScript API** / Run JavaScript.
- Finding an **existing open-source plugin** with similar functionality (to study its code) before building a new one.
- Writing or fixing a **translator** (web/import/export/search) and testing it in **Scaffold**.
- Creating or editing **CSL citation styles**; working with citeproc-js / citeproc-node.
## Reference index — load the file you need
| File | Covers |
| ------ | -------- |
| `references/web-api.md` | Base URL, auth/API keys, versioning, read requests, write requests, batch, file upload, item types/fields, syncing algorithm, streaming API, OAuth |
| `references/client-and-plugins.md` | Internal JavaScript API (Zotero.Items/Item/Search/DB/Notifier), Run Jav