lit-survey

Searches Zotero, Obsidian, local PDFs, and the web to build a literature landscape map with identified research gaps.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/megumi-ben/work17 --skill lit-survey-megumi-ben
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lit-survey
Source: https://github.com/megumi-ben/work17/tree/main/AutoVibeIdea/skills/lit-survey
Command: npx skills add https://github.com/megumi-ben/work17 --skill lit-survey-megumi-ben

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Conducting a literature survey requires manually searching multiple sources, reading dozens of papers, and synthesizing findings into a coherent picture of the field. This Skill automates that process by aggregating papers from your Zotero library, Obsidian notes, local PDFs, and web sources, then producing a structured landscape map with thematic analysis and a gap identification matrix. ## Core Features & Use Cases - Multi-source paper discovery: Searches Zotero (via MCP), Obsidian vaults, local PDF libraries, arXiv, Semantic Scholar, and Google Scholar with graceful fallback when a source is unavailable. - Thematic synthesis and gap matrix: Groups 15-30 papers into themes, classifies gaps by type (cross-domain transfer, untested assumption, scaling frontier, etc.), and assigns confidence levels. - Structured outputs: Writes LANDSCAPE.md for human reading and LANDSCAPE.json for downstream skills like idea generation and screening, plus optional author trajectory tracing. - Use Case: A researcher starting work on diffusion models runs the skill to get a landscape of 25 papers, 5 major themes, and 8 identified gaps, then feeds the JSON directly into an idea-generation workflow. ## Quick Start Ask the assistant to run a literature survey on your research topic, for example: run a literature survey on diffusion models for video generation.

Frequently Asked Questions about lit-survey

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a literature survey on a research topic?

Invoke the skill with your research topic as the argument, such as a literature survey on diffusion models. It searches Zotero, Obsidian, local PDFs, and the web, then writes a landscape map with themes and gaps to the outputs directory.

How to search only specific sources like Zotero or local PDFs?

Use the sources directive in your request, for example sources: zotero, local to search only Zotero and local PDFs. Valid values are zotero, obsidian, local, web, and all, with all being the default.

Does the literature survey work without Zotero or Obsidian configured?

Yes, the skill degrades gracefully when MCP servers are unavailable. It falls back to local PDF scanning and web search via arXiv, Semantic Scholar, and Google Scholar, and never fails due to a missing source.

Can the skill download arXiv papers automatically?

By default it only fetches arXiv metadata such as titles, abstracts, and authors. Set arxiv download to true in your request to download the top 3-5 most relevant PDFs into your local paper library.

What happens if web search fails during the survey?

The skill retries failed queries once, then falls back to building the landscape from model training knowledge. The output is clearly marked as offline mode and the pipeline continues without stopping.

What output files does the literature survey generate?

It writes LANDSCAPE.md with an executive summary, paper table, thematic analysis, and gap matrix, plus LANDSCAPE.json for machine-readable consumption by downstream idea-generation and screening skills.