mcpField
L
literature-report

literature-report

github.com/allenaiDocuments4292 installsUpdated 1d ago
Repository

About literature-report

literature-report is a skill for creating or updating cited literature reviews and reports in Markdown. It guides paper discovery, BibTeX maintenance, citation formatting, and verification that citations render correctly.

Key features

  1. 01Create or update Markdown reports
  2. 02Check and use existing search results
  3. 03Add BibTeX entries consistently
  4. 04Insert citations in the specified format
  5. 05Preview and verify citations

Use cases

  1. 01Writing cited literature reviews
  2. 02Adding new papers to an existing report
  3. 03Checking citation keys against the bibliography

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/allenai/asta-plugins --skill literature-report

After installing, type/literature-reportin Claude Code to confirm it loaded.

Details

From the project README

Literature Reports

Create or update literature reviews/reports as markdown documents with citations.

Finding Papers

  • Check .asta/documents/literature/find/ for existing search results before running new searches.
  • Use the Find Literature skill for comprehensive searches and for the result schema and jq access patterns.
  • Use the Semantic Scholar Lookup skill for targeted queries: specific papers, citations, and author searches.

Workflow Guidance

  • Identify or create the report file first. Check if there's an existing report to update. New reports go in user-visible locations (e.g., docs/), not inside .asta/.
  • When updating an existing report, read it first to understand the current structure and content.
  • When using Find Literature results, go through ALL highly relevant papers — extract relevance criteria, snippets, and citation contexts from each.

Citation Conventions

YAML frontmatter — required for citation resolution:

---
bibliography: ../references.bib
---

Citations: Use [@key] format. Every key must exist in the .bib file — unresolved keys won't render.

Adding papers to .bib: As you cite a paper, fetch its metadata and append a BibTeX entry:

asta papers get CorpusId:<id> --fields title,authors,year,venue,externalIds,journal,publicationDate

Generate a BibTeX entry from the result. Conventions:

  • Key: {firstAuthorSurname}{year} lowercased, ASCII only (e.g., wei2022). Append a letter for conflicts (wei2022a).
  • corpus_id: Include corpus_id = {<id>} for stable identification (survives key renames).
  • Append to the .bib — never rewrite existing entries.

Verification: Use the Preview skill to render and verify all citations resolve.

Comments

Markdown supported