papi
使用paperpipe (papi)帮助处理论文参考。当用户询问论文、想要对照论文验证代码、需要论文上下文进行实现,或询问文献中的方程/方法时使用。
📖 中文导读:使用paperpipe (papi)帮助处理论文参考。当用户询问论文、想要对照论文验证代码、需要论文上下文进行实现,或询问文献中的方程/方法时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: papi description: Help with paper references using paperpipe (papi). Use when user asks about papers, wants to verify code against a paper, needs paper context for implementation, or asks about equations/methods from literature. allowed-tools: Read, Bash, Glob, Grep
Paper Reference Assistant
Use when user mentions papers, arXiv IDs, equations, or "does this match the paper?"
Setup
papi path # DB location (default ~/.paperpipe/; override via PAPER_DB_PATH)
papi list # available papers
Decision Rules (Cheapest First)
papi show <paper> -l eq|tex|summary— prints to stdout- MCP tools for "top passages about X":
leann_search(index_name, query, top_k)— fast, returns snippetsretrieve_chunks(query, index_name, k)— slower, formal citations- Check indexes:
leann_list()orlist_pqa_indexes() - Embedding priority: Voyage AI → Google/Gemini → OpenAI → Ollama
papi ask— only when user explicitly requests RAG synthesis
Code Verification
papi show {name} -l eq— compare symbols with implementationpapi show {name} -l tex— exact definitions if ambiguouspapi notes {name}— implementation gotchas
Implementation Guidance
papi show {name} -l summary— high-level approachpapi show {name} -l eq— formulas to implement
Cross-Paper Search
papi search --rg "query" # exact text (fast, no LLM)
papi search --rg --regex "pattern" # regex (OR, wildcards)
papi search "query" # ranked BM25
papi search --hybrid "query" # ranked + exact boost
papi ask "question" # PaperQA2 RAG
papi ask "question" --backend leann # LEANN RAG
Adding Papers
papi add 2303.13476 # arXiv ID
papi add https://arxiv.org/abs/... # URL
papi add --pdf /path/to.pdf # local PDF
papi add --pdf "https://..." # PDF from URL
papi add --from-file papers.bib # bulk import
Per-Paper Files
Located at {db}/papers/{name}/:
| File | Best For |
|---|---|
equations.md |
Code verification |
summary.md |
Understanding approach |
source.tex |
Exact definitions |
notes.md |
Implementation gotchas |
figures/ |
Architecture diagrams, plots |
If agent can't read ~/.paperpipe/, export to repo: papi export <papers...> --level equations --to ./paper-context/
Use --figures to include extracted figures in export.
See commands.md for full reference.