hermes

Literature review track

Takes a literature review from research question and search strategy through screening, an extraction matrix and a written synthesis, with approval between steps. For students and researchers.

Runs a literature review on "" the way a supervisor would expect: a protocol first, a reproducible search, transparent screening, a faithful extraction matrix, then a thematic synthesis. Each step writes one artifact and stops for approval, and later steps build on the approved artifacts instead of re-asking.

Rules for every step: work only from records and texts the user supplies or that you retrieved with a search tool in this session; never invent a paper, citation, DOI or count; say "not reported" or "not available" instead of guessing; and keep a running list of decisions so the review can be reported honestly (for example with PRISMA for systematic reviews).


Step 1: Question and protocol

Turn "" into a review protocol the rest of the track can follow.

  1. Ask, in one message, only what you need and cannot infer: the purpose (thesis chapter, article, grant, policy brief), the review type they need or can afford (narrative, scoping, systematic, rapid), the deadline, the citation style, and any must-include sources or databases they have access to. If the question is too broad to search, propose two or three narrower versions to choose from.
  2. Restate the question with the framework that fits it: PICO or PECO for interventions and exposures, PEO or SPIDER for qualitative and mixed questions, PCC for scoping reviews. Show each element.
  3. Write inclusion and exclusion criteria: population, intervention or phenomenon, comparator, outcomes, study designs, languages, publication years and publication types (for example peer-reviewed only, or including preprints and grey literature), each with a one-line reason.
  4. List the main concepts the search must cover, and the outcome or themes the synthesis will report.

Write the protocol as Markdown with sections Question, Framework, Criteria, Concepts, Deliverable (with review type and citation style). Flag any criterion that will make the review too narrow (very few studies likely) or too broad (thousands of records).

Stop and wait for approval.


Step 2: Search strategy

Using the approved protocol, design a search that someone else could rerun and get the same records.

  1. For each concept, list synonyms, spelling variants, truncation (for example adolescen*) and the database's controlled vocabulary where one exists (MeSH for PubMed, Emtree for Embase, ERIC descriptors, APA Thesaurus terms). Flag any subject heading you are not sure exists.
  2. Combine terms with OR inside a concept and AND across concepts, then write one string per database, adapted to its syntax and field tags.
  3. Add supplementary methods: backward and forward citation chasing from key papers, grey literature sources that fit the field, and trial or preprint registries where relevant.
  4. If you have a web or literature search tool, run the strings, and record the date, the database and the number of results for each. If you do not, give the strings and ask the user to run them and paste back the exported records (titles, abstracts and citation details).

Write a search log as Markdown: a table of database | string | date run | results, followed by the supplementary methods.

Never list papers you did not retrieve in this session or receive from the user, and never estimate a result count you did not see.

Stop and wait for approval and for the records.


Step 3: Screening

Screen the records the user supplied against the approved criteria.

  1. Remove duplicates (same title and first author, or same DOI) and count them.
  2. Screen titles and abstracts. For each record give a decision, include, exclude or unsure, and for exclusions the single criterion that fails (for example "wrong population", "not empirical", "outside date range"). Treat "unsure" as include for full-text review; it is cheaper to read one more paper than to miss one.
  3. Screen the full texts the user then provides, with a reason for every exclusion.
  4. Count records at each stage: identified, duplicates removed, screened, excluded at title and abstract, full texts assessed, excluded with reasons, included.

For a narrative or rapid review, a decisions table and the final counts are enough; note what you simplified.

Write the screening record as Markdown: a decisions table (ID | citation | decision | reason) and the counts laid out as a PRISMA-style flow in text. For a systematic review, remind the user that a second, independent screener on at least a sample of records is expected, and how to report agreement.

Stop and wait for approval and for the full texts of included studies.


Step 4: Extraction and appraisal

Extract data from the included studies into one matrix.

  1. Use these columns unless the protocol says otherwise: ID (first author + year), aim, design, setting and country, sample (size and who), exposure or intervention, comparator, outcomes and measures, key findings with numbers, limitations, funding.
  2. Fill each cell from that study's text only. Copy numbers exactly. Write "NR" when a value is not reported and add "[inferred]" when you derived it rather than read it.
  3. Appraise each study with a tool that fits its design and say which one you used, for example RoB 2 for randomised trials, ROBINS-I for non-randomised interventions, the CASP or JBI checklists for qualitative and observational studies, and MMAT for mixed methods. Give the overall judgement and the one or two domains that drive it. For a narrative review, a short strengths-and-limitations note per study may replace the tool.
  4. Note anything that makes studies hard to compare (different measures, follow-up times or definitions).

Write the matrix and the appraisal table as Markdown, followed by extraction notes listing every NR, every inference and every judgement call.

Stop and wait for approval.


Step 5: Synthesis

Write the review's synthesis from the approved matrix and appraisal, answering "".

  1. Group the findings into themes that answer the question, not one paragraph per study. For quantitative findings that cannot be pooled, use a structured narrative synthesis: group by outcome, report direction and size of effects, and give weight to the stronger designs and lower risk of bias.
  2. For each theme, write a topic sentence that makes a claim, the evidence from several studies, and why studies agree or differ.
  3. State how confident the evidence lets you be for each main finding (for example strong, moderate, limited, conflicting) and why, in the spirit of GRADE where it applies.
  4. Close with the gaps the review exposes and the limitations of the review itself: databases searched, languages, single screener, date of search.
  5. Cite only included studies, in the citation style set in the protocol (APA if none was given), and add the reference list.

Write the synthesis as Markdown with a methods summary paragraph (search, screening counts, appraisal tools), the thematic findings, the gaps, the limitations and the references. Finish with what the user must check before submitting: missing citation details, claims resting on one study, counts to confirm.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Workflow: ordered steps with a checkpoint between them
domain
Research and science
category
Literature review
level
Intermediate
made for
Researcher / scientist, Student
risk
read-only
version
v1.1.0 · incubating
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install literature-review-track --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill literature-review-track -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the research-science plugin
claude plugin install hodios-research-science@hodios

The plugin brings every entry in this domain at once.

PromptLiterature review

Build a literature matrix

Extracts a comparison matrix across several papers (question, design, sample, findings, limitations) with every cell traceable to its source. Use when organising sources for a literature review.

build-literature-matrix
PromptLiterature review

Find research gaps

Identifies gaps, contradictions and open questions across a set of abstracts or notes, ties each to its sources and turns it into a researchable question. Use when scoping a thesis, grant or review.

find-research-gaps
PromptLiterature review

Write a literature review section

Synthesises sources into a thematic literature review section with in-text citations and a reference list, organised by idea rather than paper by paper. Use for theses, articles and proposals.

write-literature-review-section
PersonaResearch methods

Research methodologist

Research methodologist who probes study designs for validity threats, matches methods to questions and asks what evidence would change the conclusion. Use as a sparring partner for any study.

research-methodologist
RuleFact-checking

Source and citation rules

Standing rules for research answers that require sources for factual claims, separate evidence from inference, and forbid invented citations, links or quotes. Use in any research or writing setup.

source-citation-rules
PromptLiterature review

Summarise a research paper

Summarises a research paper into its question, method, key results with exact numbers, limitations and what it means for the reader's purpose. Use before citing, relying on or reading a paper in full.

summarize-paper