msearch

Searches multiple literature sources and synthesizes a ranked research landscape report.

75|7|Updated May 2, 2026
One-click install
npx skills add https://github.com/zjunlp/Mechanist --skill msearch-zjunlp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: msearch
Source: https://github.com/zjunlp/Mechanist/tree/main/skills/msearch
Command: npx skills add https://github.com/zjunlp/Mechanist --skill msearch-zjunlp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding relevant research papers requires manually querying many disconnected sources — arXiv, web search, Zotero, Obsidian, local PDFs, and cloud paper databases — then merging and de-duplicating the results by hand. This Skill runs one query across all of them and returns a single merged, ranked result set with a synthesized landscape report. ## Core Features & Use Cases - Multi-source retrieval: Queries Zotero, Obsidian, local PDF libraries, web search, the arXiv API, and a cloud mechanic-db SEARCH service in one pass, with optional Semantic Scholar, DeepXiv, and Exa extras. - De-duplication and ranking: Merges results across sources by normalized title, arXiv ID, or DOI, and ranks the top papers by relevance to the query. - Structured output: Writes a raw retrieval dump (RESEARCH_LIT.md) and a synthesized landscape report (LANDSCAPE.md) with a paper table, narrative summary, and structural gaps into a per-query folder. - Use Case: Ask "find papers on activation steering across all sources" and receive a deduplicated paper table plus a 3-5 paragraph field narrative saved under msearch/activation_steering/. ## Quick Start Run /msearch followed by your research query, for example: search everything for mechanistic interpretability of attention heads.

Frequently Asked Questions about msearch

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

FAQPage Schema
How do I search for papers across arXiv, Zotero, and the web at once?

Run /msearch followed by your query. It searches Zotero, Obsidian, local PDFs, web search, the arXiv API, and the mechanic-db cloud service in one pass, then merges and de-duplicates results into a single ranked set.

What sources does a multi-source literature search tool cover?

The base set covers Zotero, Obsidian, local PDFs, web search, arXiv, and the mechanic-db cloud database. Optional extras add Semantic Scholar for published venue papers, DeepXiv for progressive retrieval, and Exa for broad web content.

Does the literature search work if Zotero or Obsidian is not configured?

Yes. If a Zotero or Obsidian MCP server is unavailable, that source is skipped silently and the remaining base sources still run. Web search and arXiv are always available, so the search never fails due to a missing integration.

Can I download arXiv PDFs automatically during a literature search?

Yes, by passing the arxiv download option set to true. The top-ranked arXiv papers are downloaded to the papers/ folder, up to a configurable maximum, with rate limiting and size verification. By default only metadata is fetched.

What output files does the search produce and where are they saved?

Each run writes two files under msearch/<query-slug>/: RESEARCH_LIT.md with the raw retrieval dump including verbatim abstracts, and LANDSCAPE.md with the structured paper table, narrative synthesis, and structural gaps.