Zotero Actions Tags Guide
Apps & Automationzotero-actions-tags-guideZotero Actions Tags Guide is an Agent Skill for apps & automation published in the brycewang-stanford/Auto-Empirical-Research-Skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Zotero workflow automation with custom actions and tags
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/blob/HEAD/skills/43-wentorai-research-plugins/skills/literature/metadata/zotero-actions-tags-guide/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/zotero-actions-tags-guide, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Zotero Actions & Tags Guide
Overview
Zotero Actions & Tags is a powerful Zotero plugin that enables workflow automation through event-triggered actions. Define custom rules that execute when items are added, modified, opened, or tagged — such as auto-tagging by collection, running scripts on PDF open, auto-renaming attachments, or sending notifications. Transforms Zotero from a passive reference manager into an active research workflow engine.
Installation
# Download .xpi from GitHub releases
# In Zotero 7: Tools → Add-ons → Install Add-on From File
Core Concepts
### Event → Condition → Action
**Events** (triggers):
- Item added to library
- Item added to collection
- Item modified
- Tag added/removed
- Attachment opened
- Item selected
**Conditions** (filters):
- Item type (article, book, etc.)
- Collection membership
- Tag presence/absence
- Field value match (regex)
- Date range
**Actions** (responses):
- Add/remove tags
- Set field values
- Run JavaScript
- Open URLs
- Copy to clipboard
- Show notifications
Action Examples
Auto-Tag by Collection
{
"name": "Auto-tag ML papers",
"event": "add_to_collection",
"condition": {
"collection": "Machine Learning"
},
"actions": [
{"type": "add_tag", "tag": "#ml"},
{"type": "add_tag", "tag": "#to-read"}
]
}
Mark as Read on Open
{
"name": "Track reading",
"event": "open_attachment",
"condition": {
"attachment_type": "application/pdf"
},
"actions": [
{"type": "remove_tag", "tag": "#to-read"},
{"type": "add_tag", "tag": "#reading"},
{"type": "set_field", "field": "extra",
"value": "LastOpened: ${date}"}
]
}
Auto-Prioritize Highly Cited
{
"name": "Flag high-impact",
"event": "item_modified",
"condition": {
"field": "extra",
"regex": "Citations:\\s*(\\d{3,})"
},
"actions": [
{"type": "add_tag", "tag": "#high-impact"},
{"type": "add_tag", "tag": "#priority"}
]
}
Custom Script Action
// Run custom JavaScript on trigger
// Example: Auto-format author names
{
"name": "Format authors",
"event": "item_added",
"action": {
"type": "script",
"code": `
const creators = item.getCreators();
// Log to Zotero debug console
Zotero.debug('New item by: ' +
creators.map(c => c.lastName).join(', '));
`
}
}
Workflow Recipes
Reading Pipeline
[
{
"name": "New → To-Read",
"event": "item_added",
"actions": [{"type": "add_tag", "tag": "#to-read"}]
},
{
"name": "To-Read → Reading",
"event": "open_attachment",
"condition": {"has_tag": "#to-read"},
"actions": [
{"type": "remove_tag", "tag": "#to-read"},
{"type": "add_tag", "tag": "#reading"}
]
},
{
"name": "Reading → Done",
"event": "tag_added",
"condition": {"tag": "#done"},
"actions": [
{"type": "remove_tag", "tag": "#reading"}
]
}
]
Auto-Organization
[
{
"name": "Tag by journal",
"event": "item_added",
"condition": {
"field": "publicationTitle",
"regex": "Nature|Science|Cell"
},
"actions": [
{"type": "add_tag", "tag": "#top-journal"}
]
},
{
"name": "Flag recent papers",
"event": "item_added",
"condition": {
"field": "date",
"after": "2024-01-01"
},
"actions": [
{"type": "add_tag", "tag": "#recent"}
]
}
]
Configuration
### Settings (Edit → Preferences → Actions & Tags)
- **Enable/disable** individual actions
- **Action priority** — execution order when multiple match
- **Logging** — debug action execution
- **Import/Export** — share action sets with collaborators
- **Keyboard shortcuts** — trigger actions manually
Use Cases
- Reading workflow: Auto-track reading status via tags
- Auto-organization: Tag by collection, journal, or date
- Priority flagging: Highlight high-impact or recent papers
- Team workflows: Shared tag-based review pipelines
- Custom scripts: Extend Zotero with JavaScript actions