- Home
- Skills
- Technical Documentation
- Zotero Citation Audit
Works with the AI Agents you already use
Zotero Citation Audit
Submit with the right reference number on every citation: wrong, missing, orphan and out-of-order references found and fixed.
Free
Zotero Citation Audit
Example session with this skill installed
Audit the Zotero citations of demo_manuscript_revised.docx after my last refresh.
- Read your context and instructions
- Compiled the zotero citation audit
- Generated the document
Citation audit: demo_manuscript_revised.docx
Summary: 4 citation problems were found. One call kept its old number, one number was typed by hand, one reference is a true orphan, and one placeholder tag is still in the text. For comparison, the submitted version is clean: 6 fields, 6 references, 0 problems.
Audit output (audit_zotero.py --lines, unedited)
Zotero citation fields: 6 | bibliography: 7 entries (continuous numbering: True)
Distinct numbers cited: 5 | orphans: [2, 6] | missing: []
Increasing order of first citation: True
Hand-typed numbers: 1 | remaining [ZOTERO: …] tags: 1
hand-typed | paragraph: 16 | line: 30 | number: [4] | context: …enome for each genus, drawn with Tool C [4]. Bar color indicates the site: red bars…
Problems: 1
type: call -> other number (old number?) | paragraph: 10 | line: 19 | displayed: [5] | expected entry: [6] | title: Biopython: freely available Python tools for computational m | context: … Sequence files were parsed with Tool D [5].…
JSON report: zotero-citation-audit/audit_revised.json
Each problem comes with its PDF line and the text around the faulty citation.
Diagnosis
| Where (PDF line) | Problem | Explanation | Fix |
|---|---|---|---|
| §2.2, line 19, "Tool D [5]" | Call left at the old number | The field cites Biopython, which is entry [6] since Tool E (SciPy) was inserted as [5]. This is also why [6] appears as an orphan. | Zotero → Refresh; if it stays at [5], a second Refresh |
| Figure 1 legend, line 30, "Tool C [4]" | Hand-typed number | "[4]" is plain text, not a Zotero field: it will never be renumbered | Delete it, then Zotero → Add/Edit Citation → Hunter 2007 |
| Bibliography [2] (Sandve 2013) | True orphan | Its only citation (introduction, end of line 11) was deleted; the bibliography was not refreshed | Refresh removes it; or restore the citation if the deletion was a mistake |
| §2.2, lines 17–18 | Tag "[ZOTERO: Tool A]" | Placeholder for Reviewer 1's request; no reference inserted yet | Import the Tool A reference by DOI, replace the tag with a real citation |
Numbering is continuous (1–7) and the first-citation order is increasing, so no reordering is needed.
Expected after the fixes: 8 fields (Tool A and the legend citation added), 7 references, 0 hand-typed numbers, 0 tags, 0 orphans, 0 problems. If the Sandve citation is not restored, the Tool A reference takes the free number [2]; the others keep theirs (Tool D [6], Tidy data [7]).
Next steps: close the file in Word before each run, do the fixes and the Refresh, then re-run the audit until it reports 0 problems. Then update the numbers quoted in the response letter and the Supplementary Material (Zotero does not change them), regenerate the PDF and re-read the line numbers.
demo_manuscript_revised.docx
PDF · document
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
About this skill
What it does
Read-only audit of the numbered citations of a Word manuscript managed with Zotero.
- Continuity and order of first citation
- Orphan and missing references
- Hand-typed numbers that Zotero will never renumber
- Citations left at an old number after a Refresh
- Call-to-reference matching by title and DOI
Also explains how to insert missing references cleanly and what to do after a Refresh.
Included
audit_zotero.py(optional JSON report)
Field-tested on a real, successful research project.
Requires closed .docx file and live Zotero fields. Hand-typed citations are flagged but not automatically converted. Setup requires python-docx.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 4 days ago
- Free with an Agensi account
Requires