Agent skill
papi-ask
Query papers using RAG (PaperQA2 or LEANN). Use when user needs synthesized answers from papers, asks "what does paper X say about Y", or needs cited responses.
Install this agent skill to your Project
npx add-skill https://github.com/hummat/paperpipe/tree/main/skills/papi-ask
SKILL.md
Query Papers via RAG
Use papi ask for questions requiring synthesis across papers or cited answers.
Cost-Aware Retrieval
Before using RAG, consider cheaper alternatives:
- Exact match:
papi search --rg "query"— fast, no LLM - Ranked search:
papi search "query"— BM25 ranking - Direct read:
papi show <paper> -l eq|tex|summary— if you know the paper
Use papi ask only when:
- User explicitly requests RAG/synthesis
- Question spans multiple papers
- Search/show cannot answer
Commands
# PaperQA2 (default) — full RAG with citations
papi ask "question"
# LEANN — faster semantic search + LLM
papi ask "question" --backend leann
# Structured output for programmatic use
papi ask "question" --format evidence-blocks
MCP Tools (if available)
For quick retrieval without full RAG:
leann_search(index_name, query, top_k)— fast semantic searchretrieve_chunks(query, index_name, k)— PaperQA2 chunks with citations
Check available indexes: leann_list() or list_pqa_indexes()
Output
RAG answers include:
- Synthesized response
- Citations with page/section references
- Confidence indicators
For general CLI commands, see /papi.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
papi-init
Setup paperpipe agent integration. Use when user wants to add papi to a project's CLAUDE.md/AGENTS.md or initialize paper support.
papi-compare
Compare papers for a decision. Use when user asks "which paper should I use", "compare approaches", or needs to choose between methods/algorithms.
papi-curate
Create project notes from papers. Use when user wants to document paper findings, create implementation notes, or summarize papers for a project.
papi
This skill should be used when the user wants to interact with their paper database — listing papers, searching content, showing paper details, adding papers, or exporting context. Matches queries like "search papers for X", "add this arXiv paper", "show equations from paper Y", "what papers do I have". Prefer CLI over MCP RAG tools for direct lookups.
papi-verify
Verify code against paper. Use when user asks "does this match the paper", "check my implementation", or is implementing equations/algorithms from literature.
papi-ground
Ground responses in paper excerpts with citations. Use when user wants cited claims, quotes, or needs to avoid hallucination about paper content.
Didn't find tool you were looking for?