# zotero-dev-rules

zotero-dev-rules provides guidelines for Zotero Web API v3 and desktop plugin development without manual doc searches.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 293 installs · ★ 107 repo stars
- Author: Agents365-ai
- License: CC-BY-NC-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Agents365-ai/365-skills/tree/HEAD/plugins/zotero-dev-rules/skills/zotero-dev-rules/SKILL.md
- Updated: 2026-10-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/zotero-dev-rules

## What it does

This skill equips coding assistants with reference rules for the Zotero platform. It packages technical guides for desktop client JavaScript scripts, the Zotero 7 to 10 plugin architecture, and the three-stage file attachment upload workflow.

Dedicated modules cover web and export translators tested in Scaffold, alongside CSL styling powered by `citeproc-js`. A bundled catalog index of 137 community plugins helps inspect working implementations before writing a new tool.

Writing to the Web API mandates an explicit library version header such as `If-Unmodified-Since-Version`. Omitting it triggers HTTP `428`, while mismatched versions fail with `412`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill zotero-dev-rules -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/zotero-dev-rules/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/zotero-dev-rules/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill zotero-dev-rules -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/zotero-dev-rules/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill zotero-dev-rules -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/zotero-dev-rules/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Agents365-ai/365-skills plugins/zotero-dev-rules/skills/zotero-dev-rules
```

2. **Manually: put the files in place**
- File: `.github/skills/zotero-dev-rules/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill zotero-dev-rules -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Agents365-ai/365-skills --path plugins/zotero-dev-rules/skills/zotero-dev-rules
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/zotero-dev-rules/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill zotero-dev-rules -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Agents365-ai/365-skills/tree/HEAD/plugins/zotero-dev-rules/skills/zotero-dev-rules/SKILL.md

## When to use it
- interact with Zotero Web API v3 using correct version headers
- build or migrate desktop plugins across Zotero 7 and 10
- write scraping translators and test them in Scaffold
- customize CSL citation stylesheets with citeproc-js

## Example prompts
- Draft a batch write request for 15 articles using the Zotero Web API with version checking
- Create a desktop plugin script that reads selected items through ZoteroPane and saves them
- Write a web translator with detectWeb and doWeb functions for a publisher site

## Similar
- [zotero-obsidian-bridge](https://affpapa.org/en/nevibecode/skills/zotero-obsidian-bridge.md) — skill · 488 installs
- [DocsAgent — Zotero, Obsidian & Apple Notes MCP Server](https://affpapa.org/en/nevibecode/mcp/docsagent-zotero-obsidian-apple-notes-mcp-server.md) — MCP server · ★ 580 repo stars
- [Zotero Native MCP](https://affpapa.org/en/nevibecode/mcp/zotero-native-mcp.md) — MCP server · ★ 14 repo stars
- [zotero-bridge](https://affpapa.org/en/nevibecode/mcp/zotero-bridge.md) — MCP server · ★ 10 repo stars
- [zotero-paper-reader](https://affpapa.org/en/nevibecode/skills/zotero-paper-reader.md) — skill · 609 installs
- [Zotero](https://affpapa.org/en/nevibecode/skills/zotero.md) — skill · 24 installs

From the same set: [agents365-ai/365-skills](https://affpapa.org/en/nevibecode/by/agents365-ai/365-skills.md) — 33 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
