read-paper-local

name

read-paper-local

description

Read and work with local academic paper folders exported by ZoFiles from Zotero. TRIGGER when: user asks to read/summarize/cite/review/compare a paper that is already downloaded locally, references a local paper folder or path, works with paper.md/paper.bib/kimi.md files, browses the local paper library by topic, or asks to update/refresh the paper library directory structure. DO NOT TRIGGER when: user asks to search for papers online, find new papers, look up papers on a topic online, browse HuggingFace daily papers, or read a paper by arXiv ID without a local copy (use read-paper-online skill).

Reading Paper Folders

Paper folders are exported by ZoFiles from Zotero. Each folder is named {arxivId} - {title} and contains structured files about one academic paper.

Paper Library Location

The default paper library is at:

/Users/x1a/Local/ZoFiles/By Topic/

If this path doesn't exist (e.g. first-time setup or different machine), ask the user for their ZoFiles export root path.

Directory Structure

The library mirrors Zotero's collection hierarchy. Collections become directories, sub-collections become subdirectories, and paper folders sit at the leaves.

Key patterns:

• Allin/ directories appear when a collection has subcollections — contains all papers from that collection and every descendant (flat view of the entire subtree).
• Paper folders are named {arxivId} - {title} (e.g. 2512.18832 - From Word to World...).
• Find by arXiv ID: glob **/2512.18832* from the library root.
• Browse a topic: list the corresponding collection directory.
• See all papers: glob **/paper.md or **/arxiv.id recursively.