Literature Review Agent

Verifica citas de artículos, marca las alucinadas, construye BibTeX, redacta trabajo relacionado.

Probado · Funciona ★ 8.4/10

Qué hace

Ejecuta la etapa de citación de un pipeline de artículos académicos: descubre artículos candidatos a través de web search, verifica cada uno a través de Semantic Scholar (fuzzy title match, temporal cutoff, dedup), realiza verificaciones cruzadas contra Crossref y OpenAlex para marcar referencias alucinadas, construye un archivo BibTeX con deterministic keys, y redacta las secciones Introduction y Related Work. Se activa cuando se le pide encontrar citas para un artículo, redactar el trabajo relacionado o construir una bibliografía verificada.

Informe de la prueba

Se clonó el repo; los 14 scripts y cada archivo de referencia verificado (bibtex_format.py, levenshtein_match.py, dedupe_by_id.py, references/prompt.md) devuelven HTTP 200. Se ejecutó bibtex_format.py en un pool de 3 artículos construido a mano: emitió deterministic stopword-aware keys (vaswani2017attention, zhao2023survey, he2016deep), escribió eprint/doi solo cuando estaba presente, y escribió bibtex_key de vuelta en citation_pool.json — la bibliografía escrita a mano de la línea base usaría ad-hoc keys y nunca poblaría el pool, rompiendo el downstream coverage gate. check_cutoff.py y citation_coverage.py se comportaron como se especificó (coverage gates en un floor(0.9*N) count, por lo que 2/3 'passed' en count 2 — ligeramente más laxo que la redacción '≥90% of pool' de la HABILIDAD). levenshtein_match.py falla con un claro error 'pip install python-Levenshtein' hasta que se instala esa dependencia no documentada, después de lo cual devolvió 100 PASS / 31 FAIL correctamente. La web-discovery + verificación en vivo de Semantic Scholar/Crossref/OpenAlex no se ejercitaron (se necesita host web search + network), por lo que la puntuación de salida refleja solo la porción determinista de BibTeX/coverage. Sin problemas de seguridad: keys leídas de env, no curl|sh, no exfiltración.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/Ar9av/PaperOrchestra.git /tmp/literature-review-agent-src
mkdir -p ~/.claude/skills
cp -R /tmp/literature-review-agent-src/skills/literature-review-agent ~/.claude/skills/literature-review-agent
# Undocumented runtime dep: scripts/levenshtein_match.py needs python-Levenshtein
pip install python-Levenshtein
# Optional deps used only if you enable those backends / cross-index checks:
#   requests            (s2_search.py, crossref_client.py, openalex_client.py, exa_search.py)
# Optional API keys (all read from env, none committed):
#   SEMANTIC_SCHOLAR_API_KEY  — higher S2 rate limit (public endpoint works without it)
#   EXA_API_KEY               — optional Exa web-search backend for Phase 1
#   PAPER_ORCHESTRA_MAILTO    — polite-pool email for Crossref/OpenAlex
# Designed as Step 3 of the PaperOrchestra pipeline; needs a workspace/outline.json + host web search for the full run.

Comandos y prompts de ejemplo

/literature-review-agentVerifica citas de artículos, marca las alucinadas, construye BibTeX, redacta trabajo relacionado.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

Find citations for my paper's related work section
Draft the related work from this outline.json
Verify these citations against Semantic Scholar

Informe completo →