agentleFS
Agentic-AssetsAgentic-Assets/corbis-mcp/skills/literature-review/SKILL.md

literature-review

Skill0 starsChanged 39 days agoMITView on GitHub

Cited literature reviews, claim checks, and paper positioning in finance, real estate, and economics using the Corbis research connector. Use when the user asks for a literature review, asks what research says about a topic, wants to find papers on a question, asks whether a claim is supported by research, asks where their paper fits in the literature, or asks about research gaps.

84 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use pdf-explore, paper-narrative and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • JimLiuSkill

    pdf-explore

    Use this skill when the user has attached a PDF, paper, report, or other document and the answer needs content from more than one place in it: summarize the methods or any other section, compare sections, find where a topic is discussed, read a value or label off a figure or chart, or find/list/extract every instance of something across the whole document (datasets, benchmarks, citations, figures, table rows, accession numbers — including appendices). Skip it only for a single lookup of 1–4 pages quoted in your very next response — `read_file(pages=[...])` attaches pages as images that are dropped from context after one turn, so multi-section answers end up re-reading the same ranges repeatedly. Parses the PDF once in the Python kernel: `pdf_pages` (pages as persistent text), `pdf_outline` (TOC), `pdf_scan` (rank pages by relevance), `pdf_map`/`pdf_extract` (per-page summary / structured fields via parallel haiku calls). For PDF creation/manipulation, use reportlab/pypdf directly.

    Also in 9 projects that use this

  • JimLiuSkill

    paper-narrative

    Judge and reshape the STORY a paper's figures tell. Input is the work itself — manuscript (or abstract) + figure deck — no hand-written brief. `derive_paper_brief(abstract, captions)` extracts pitch/vision/per-figure-claims; a handling-editor reviewer on the full deck returns hook_verdict (would Fig 1 make me send this for review?), arc (hook→mechanism→evidence→application), figure_moves (panels in the wrong figure), missing_panels (concrete analyses to RUN), kill_list, and boldest_defensible_fig1. Hands per-figure claims to `figure-composer`. Load when writing or revising a paper.

    Also in 5 projects that use this

  • Norman-burySkill

    brainstorming-research

    Use before writing any paper - clarifies paper type, discipline, topic, methodology, and chapter structure through natural dialogue

    Also in 4 projects that use this

  • lingzhi227Skill

    latex-formatting

    Handle LaTeX formatting, templates, and styling for academic papers. Set up conference templates (ICML, ICLR, NeurIPS, AAAI, ACL), fix formatting issues, manage packages, and ensure venue-specific compliance. Use when the user needs to set up a paper template, fix LaTeX formatting, or prepare for submission.

    Also in 4 projects that use this

  • lingzhi227Skill

    novelty-assessment

    Assess research idea novelty through systematic literature search. Multi-round search-evaluate loops with harsh critic persona. Binary novel/not-novel decision with justification. Use before committing to a research direction.

    Also in 4 projects that use this

  • +6 more from JimLiu
  • +1 more from lingzhi227

The file

We split this skill into the rules it gives an agent

12 rules. 0 are common, 3 are distinctive, and 9 are very specific to this project.

  • 0

    Common

    Most of the 65 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 9

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Research question or review: follow Quick or Full below.

    line 21
  2. Distinctive:

    "Is this claim supported?": follow Claim check.

    line 22
  3. Distinctive:

    "Where does my paper fit?" or "What are the gaps?": follow Positioning.

    line 23
  4. Very specific:

    If the returned metadata and any requested abstract snippets are not enough, call get_paper_details_batch once on the three to eight most …

    line 28
  5. Very specific:

    If your client can read MCP resources, read docs://workflow-packs/literature-search first and follow it where it adds detail: use its …

    line 34
  6. Very specific:

    Call literature_retrieve once per distinct sub-question (usually one to three calls).

    line 37
  7. Very specific:

    Call get_paper_details_batch on the papers you keep, at most 25 IDs per call.

    line 38
  8. Very specific:

    When the question maps to specific journals, call top_cited_articles once for field context.

    line 39
  9. Very specific:

    Write the review using references/output-format.md.

    line 40
  10. Very specific:

    Call evidence_pack with the claim, plus any paper IDs already retrieved in this conversation.

    line 47
  11. Very specific:

    Ask for the paper's abstract if the user has not supplied one, or condense it into a contribution statement of a few sentences: …

    line 53
  12. Very specific:

    Call literature_positioning with that text to find the closest papers.

    line 54

“Common” is measured: kept by at least 6 in 10 of the 65 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Literature review

Answer research questions with papers that Corbis retrieves, and keep every claim traceable to a returned source.

Ground rules

  • Cite only papers, data, and quotes that a Corbis tool returned in this conversation or that the user supplied. Never invent a DOI, author, year, title, or quote.
  • Say when evidence is thin, old, mixed, or limited to one market or domain. Never describe the output as free of errors or hallucinations.
  • Some optional steps use premium tools that need an enterprise plan. If a premium tool is not in your tool list, or returns an access or plan error, tell the user once that the step needs an enterprise plan (current plans: https://www.corbis.ai/pricing), then continue with the standard tools. Never retry a denied tool.
  • Research tool calls may use Corbis credits. Use a batch tool when one exists, and never re-fetch details for a paper already retrieved in this conversation.
  • Quick mode is the default for a narrow question: at most 5 Corbis tool calls, a short cited answer, then an offer to run the full workflow. Use full mode when the user asks for a review, report, or audit, or accepts that offer.
  • If no Corbis tools are available, or a Corbis call returns a sign-in or connection error, first retry the call once through any other Corbis connection in your tool list (the same tool name from another Corbis server). That retry counts toward the quick-mode limit, so skip it when no calls remain. If none works, ask the user to connect or reconnect Corbis (the plugin's Connectors tab, or /mcp in Claude Code) instead of answering from memory. Do not switch to another source, such as a web search or another citation database, unless the user asks, and label anything from another source as not verified by Corbis.

Choose the task

  • Research question or review: follow Quick or Full below.
  • "Is this claim supported?": follow Claim check.
  • "Where does my paper fit?" or "What are the gaps?": follow Positioning.

Quick (narrow question)

  1. Call literature_retrieve with the question as researchQuestion and a low perQueryLimit; set includeAbstracts if you expect to need abstracts. Pass a journal constraint as journalNames and a year window as minYear and maxYear, and never drop a constraint to widen results. The tool has no field filter: state a field or market constraint in researchQuestion and set aside returned papers outside it.
  2. If the returned metadata and any requested abstract snippets are not enough, call get_paper_details_batch once on the three to eight most relevant papers.
  3. Answer in a few short paragraphs with author-year citations, then list the sources (authors, year, title, journal, DOI or link exactly as returned).
  4. Offer the full literature review.

Full review

If your client can read MCP resources, read docs://workflow-packs/literature-search first and follow it where it adds detail: use its phases and contracts, and do not create local files or subagents.

  1. Restate the question, field, time window, and constraints. Ask one clarifying question only if the scope is ambiguous enough to change the search.
  2. Call literature_retrieve once per distinct sub-question (usually one to three calls). Do not re-run it with paraphrases of the same query.
  3. Call get_paper_details_batch on the papers you keep, at most 25 IDs per call; split a larger set into batches.
  4. When the question maps to specific journals, call top_cited_articles once for field context.
  5. Write the review using references/output-format.md.
  6. If the user wants the references as a file, call export_citations (BibTeX, Markdown, or JSON). For a named citation style (APA, MLA, Chicago, or Harvard), call format_citation with that style using the metadata already returned by get_paper_details_batch; say that formatting does not re-verify it. For a Markdown or BibTeX reference list instead of a named style, use render_citations.

Managed synthesis upgrade: if the user asks Corbis to write the synthesis itself, literature_search can replace steps 2 to 5 on enterprise plans; if it is unavailable or denied, run the steps above. When literature_search does run, call get_paper_details_batch before step 6 on the papers you cite whose full metadata it did not return, at most 25 IDs per call.

Claim check

  1. Call evidence_pack with the claim, plus any paper IDs already retrieved in this conversation.
  2. evidence_pack returns abstract-level evidence, not a verdict. Report which returned papers appear to bear on the claim and in which direction, labeled as abstract-level leads, or say the evidence is insufficient. Do not call the claim supported or contradicted unless you inspected the relevant paper with get_paper_details_batch (or the user supplied its text); otherwise say that confirming it needs a closer read. Cite each paper you rely on and quote only text the tool returned.
  3. Scored verification upgrade: on enterprise plans, claim_verification gives a scored verdict. Offer it only after the Tier 1 answer, and follow the ground rules if it is unavailable or denied.

Positioning

  1. Ask for the paper's abstract if the user has not supplied one, or condense it into a contribution statement of a few sentences: literature_positioning's input has a short length cap.
  2. Call literature_positioning with that text to find the closest papers. Its results are candidate positioning hints, not verified distinctions: inspect the closest papers with get_paper_details_batch before stating how the contribution differs.
  3. For gaps and open questions, call research_opportunity_map on the topic.
  4. Report the closest papers, the claimed difference, and where the difference is weak. Label any difference you did not check against an inspected paper as an unverified candidate. research_opportunity_map returns candidate leads only: present its gaps as unverified candidates, or confirm the ones that matter with literature_retrieve or get_paper_details_batch before calling a gap supported. Mark any gap you infer beyond the returned evidence as your own judgment.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.