literature-survey
Skill3 starsChanged 3 months agoMITView on GitHub
Build a critical or explanatory literature review through iterative, question-driven inquiry. Use when the goal is to explain a field, resolve conflicting studies, trace concepts, test a literature claim, or identify a defensible research gap. Do not use for a simple bibliography, a one-paper summary, or a fixed systematic-review protocol whose primary task is exhaustive screening.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- a-attia/scicomp-research-skillstheir own version, first seen Nov 1, 2026
- DanieleMosh/almagest-surveytheir own version, first seen Oct 15, 2026
- JihaoXin/paper-machinetheir own version, first seen Oct 15, 2026
- haozhou-wong/haozhou-skillstheir own version, first seen Jul 27, 2026
- stc980309-pixel/In-depth-researchtheir own version, first seen Jun 10, 2026
- yicheng-fu/skillstheir own version, first seen May 8, 2026
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- stc980309-pixel/In-depth-research★ 17same name
- a-attia/scicomp-research-skills★ 13same name
- DanieleMosh/almagest-survey★ 1same name
- haozhou-wong/haozhou-skills★ 1same name
- yicheng-fu/skills★ 1same name
- JihaoXin/paper-machine★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository6 other files it gives its agents.
- browserSkill
- cite-reviewSkill
- literature-writingSkill
- overleaf-setupSkill
- paper-download-browserSkill
- paper-reproduceSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. 0 are common, 6 are distinctive, and 7 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
7
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 21
Do not freeze a complete taxonomy, search plan, or chapter outline before orientation unless the user explicitly requests a protocol-led …
- Very specific: line 27
Use the shared literature workspace conventions in that reference.
- Distinctive: line 44
Keep synthesis, conflict resolution, conceptual restructuring, warrants, qualifiers, and prose architecture in the main agent.
- Very specific: line 48
use literature-scout for a single search move.
- Very specific: line 49
use paper-reader for question-directed reading without graph writes.
- Very specific: line 50
use literature-extractor only for a small set of pivotal papers when their source-grounded findings should enter the graph as unestablished …
- Very specific: line 51
use toulmin-explorer to retrieve a relevant graph neighbourhood without loading unrelated graph state.
- Very specific: line 52
use discrepancy-auditor for one important apparent contradiction or claimed barrier.
- Very specific: line 53
use rigor-auditor only as a completion gate.
- Distinctive: line 57
Every delegation must satisfy references/delegation.md.
- Distinctive: line 71
Do not require a universal extraction form for every paper.
- Distinctive: line 95
Consider stopping when new work rarely changes the central explanation, major counterexamples have been handled, concepts have stable …
- Distinctive: line 97
Do not claim systematic coverage, PRISMA compliance, or an exhaustive research gap unless the corresponding protocol and records actually …
“Common” is measured: kept by at least 6 in 10 of the 3 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.
Files
Inquiry Literature Review
Build an explanation, not a pile of paper summaries. Treat search, reading, and extraction as moves made against the current argument. Let discoveries revise the question, concepts, and candidate explanations.
The toulmin-researcher is the inquiry owner. It keeps the user-facing conversation, chooses the next uncertainty, integrates results, controls the argument graph, and alone decides qualifiers. Delegate bounded evidence work when doing so protects its working context or supplies an independent challenge.
Start or Resume
On a new review, establish:
- the phenomenon or disagreement that needs explanation;
- what a useful review should let its reader understand or decide;
- provisional scope and important exclusions;
- any required review convention or deliverable.
Do not freeze a complete taxonomy, search plan, or chapter outline before orientation unless the user explicitly requests a protocol-led systematic review.
On a resumed review, read the compact inquiry state, open tensions, recent changes, and relevant argument neighbourhood. Do not reload the entire source collection into the main context.
Maintain durable state using references/state.md. The files are working memory, while the Warranted graph contains only propositions whose credibility materially affects the review.
Use the shared literature workspace conventions in that reference. In particular, store source PDFs as papers/<bibkey>.pdf; the filename stem is both the BibTeX key and the key that literature-writing and the Overleaf push integration resolve from proposition attachments.
Run Inquiry Rounds
Each round addresses one consequential uncertainty:
- State the current question or proposition.
- State what observations would support it and what would defeat, narrow, or reframe it.
- Choose one research move from references/research-moves.md.
- Decide whether to work directly or delegate.
- Integrate returned evidence into the current explanation.
- Record what changed and choose the next uncertainty.
A round that finds nothing material may close without adding a graph proposition. Do not create nodes to represent activity.
Delegate Deliberately
Keep synthesis, conflict resolution, conceptual restructuring, warrants, qualifiers, and prose architecture in the main agent.
Delegate work that is bounded by a stable question and can return through an artifact:
- use
literature-scoutfor a single search move; - use
paper-readerfor question-directed reading without graph writes; - use
literature-extractoronly for a small set of pivotal papers when their source-grounded findings should enter the graph as unestablished propositions; - use
toulmin-explorerto retrieve a relevant graph neighbourhood without loading unrelated graph state; - use
discrepancy-auditorfor one important apparent contradiction or claimed barrier; - use
rigor-auditoronly as a completion gate.
Parallelize independent evidence obligations within a round, commonly support search, adversarial search, concept tracing, and method comparison. Integrate the round before dispatching work whose question depends on those results. Do not let multiple agents revise the same synthesis proposition, decide a qualifier, or draft the same argument unit.
Every delegation must satisfy references/delegation.md. Prefer 2–4 purposeful workers over broad fan-out. Parallelism that creates more integration work than discriminating evidence is a loss.
Read for Argument Change
For a pivotal paper, distinguish:
- what was done and measured;
- what the results directly establish;
- what the authors claim;
- which assumptions connect the two;
- which scope conditions matter;
- how the paper changes the current explanation;
- exact passages, tables, or figures supporting that change.
Do not require a universal extraction form for every paper. The current question determines what must be extracted.
Use the Argument Graph
Put a proposition in Warranted only when assessing it affects the research question or a downstream conclusion. Attach source material or a question-directed evidence note. Use evidence propositions for source-grounded findings, rebuttals for material counterevidence, and warrants for the reasoning that carries findings to a synthesis claim.
Do not map one paper to one node by default. Do not use the graph as a bibliography, task tracker, or reading log. Subagents may recommend graph consequences, but the main agent interprets them before changing synthesis state. Only the main agent sets or resets a qualifier.
Write from Stable Argument Units
Draft a section only when a local argument can identify:
- the phenomenon or tension;
- competing explanations;
- discriminating evidence;
- the best current resolution or conditional account;
- residual uncertainty.
Organize prose around explanatory work, not paper-by-paper chronology unless historical development is itself the question. Preserve meaningful disagreement rather than forcing consensus.
When the deliverable is LaTeX, hand stable argument units to literature-writing and write them under manuscript/. That skill owns the \cite{prop_N} citation contract and graph-to-prose consistency. If Overleaf synchronization is requested, run overleaf-setup with manuscript/ as LATEX_DIR; do not make the whole review workspace the Overleaf project.
Stop Responsibly
Consider stopping when new work rarely changes the central explanation, major counterexamples have been handled, concepts have stable boundaries, and remaining uncertainty can be stated precisely. Before completion, run the rigor audit and disclose source-access, search, disciplinary, language, and inference limits.
Do not claim systematic coverage, PRISMA compliance, or an exhaustive research gap unless the corresponding protocol and records actually support that claim.
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
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.

