Agent skill

zotero-paper-import

Download PDFs from Zotero by citation key, cut references, and prepare for Swanki.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/zotero-paper-import

SKILL.md

When the user asks to import papers from Zotero, follow this workflow:

Input

The user provides one or more citation keys as arguments, e.g.:

  • /zotero-paper-import montanolopezPhysiologicalLimitationsOpportunities2022
  • /zotero-paper-import key1 key2 key3

Procedure

Step 1: Run the import script

bash
/Users/michaelvolk/miniconda3/bin/python scripts/zotero_paper_import.py <key1> [key2 ...]

This single command handles everything per key:

  1. Connects to Zotero and downloads PDFs into ../Swanki_Data/{key}/
  2. Detects reference pages via PyPDF2 text extraction
  3. Cuts references with swanki-cut, creates _clean.pdf via pdfunite
  4. Writes the .sh runner script

Use --download-only to skip the cleaning step if needed.

Step 2: Handle failures

If references are NOT auto-detected for a paper (script reports "No references heading detected, keeping all pages"), manually inspect the PDF and re-run the cut using /clean-pdf {key}.

Step 3: Report summary

After all keys are processed, report:

  • Which keys were successfully imported
  • Pages kept vs removed per paper
  • Any papers where references were not detected

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results