From agent-almanac
Surveys theoretical literature on a topic, synthesizing seminal papers, key results, open problems, and cross-domain connections. Use for research starts, lit reviews, gap finding, novelty checks.
npx claudepluginhub pjt222/agent-almanacThis skill uses the workspace's default tool permissions.
---
Synthesizes existing knowledge on topics, identifies research gaps, and traces evolution of scientific ideas via systematic literature reviews using academic databases.
Conducts systematic literature reviews: defines scope, searches arXiv/Semantic Scholar/Google Scholar, screens papers, extracts data, synthesizes findings, identifies gaps. For research surveys.
Surveys research topics by launching parallel web searches across user-selected strategies like landscape mapping, builds persistent BibTeX registry. Use for literature reviews.
Share bugs, ideas, or general feedback.
Conduct a structured survey of theoretical literature on a defined topic, producing a synthesis that maps seminal contributions, traces the chronological development of key ideas, identifies open problems and active research frontiers, and highlights cross-domain connections.
Bound the survey precisely before searching:
## Survey Scope
- **Core topic**: [one-sentence definition]
- **Primary search terms**: [list]
- **Secondary search terms**: [list]
- **Exclusion terms**: [list]
- **Time window**: [start year] to [end year]
- **In scope**: [subfields]
- **Out of scope**: [subfields]
Expected: A scope definition tight enough that two researchers would independently agree on whether a given paper belongs in the survey.
On failure: If the scope is too broad (more than ~200 potentially relevant papers), narrow by adding subfield constraints or tightening the time window. If too narrow (fewer than ~10 papers), broaden the secondary search terms or extend the time window.
Build the backbone of the survey from the most influential contributions:
## Seminal Papers
| # | Authors (Year) | Title | Main Result | Impact |
|---|---------------|-------|-------------|--------|
| 1 | [authors] ([year]) | [title] | [one-sentence result] | [influence on field] |
| 2 | ... | ... | ... | ... |
Expected: A table of 5-15 seminal papers that form the intellectual backbone of the topic, with each paper's main result and impact clearly stated.
On failure: If the search yields no clear seminal papers, the topic may be too new or too niche. In that case, identify the earliest papers and the most-cited papers as anchors, and note that the field's canonical references have not yet emerged.
Trace how the field evolved from its origins to the present:
## Chronological Development
### Origin ([decade])
- [event/paper]: [description of foundational contribution]
### Key Developments
- **[year]**: [milestone and its significance]
- **[year]**: [milestone and its significance]
- ...
### Branching Points
- **[year]**: Field splits into [branch A] and [branch B]
- Branch A focuses on [topic]
- Branch B focuses on [topic]
### Current State ([year])
- **Activity level**: [mature / active / emerging / stagnant]
- **Dominant approach**: [current mainstream methodology]
- **Recent trend**: [direction of latest work]
Expected: A narrative timeline that a newcomer could read to understand how the field arrived at its current state, including the intellectual lineage of key ideas.
On failure: If the chronology is unclear (e.g., multiple independent discoveries, disputed priority), document the ambiguity rather than imposing a false linear narrative. Parallel timelines are acceptable.
Catalog what is not yet known or resolved:
## Open Problems and Frontiers
### Explicitly Open
| # | Problem | Status | Barrier | Potential Impact |
|---|---------|--------|---------|-----------------|
| 1 | [statement] | [conjecture / partial / open] | [why hard] | [incremental / significant / transformative] |
| 2 | ... | ... | ... | ... |
### Active Frontiers
- **[frontier topic]**: [what is happening and why it matters]
- ...
### Implicit Gaps
- [observation without theoretical explanation]
- [conjecture without proof]
- ...
Expected: A structured catalog of at least 3-5 open problems with difficulty assessments, plus a characterization of the most active research frontiers.
On failure: If no open problems are apparent, the survey scope may be too narrow (the sub-topic is solved) or the literature search missed the relevant review articles. Broaden the scope or specifically search for "open problems in [topic]" and "future directions in [topic]."
Connect the surveyed field to adjacent areas and assemble the final output:
Cross-domain connections: Identify where the surveyed topic connects to other fields:
Connection quality assessment: For each connection, assess whether it is:
Gap analysis: Identify connections that should exist but have not been explored. These are potential research opportunities.
Survey assembly: Compile the outputs from Steps 1-5 into a structured document:
## Cross-Domain Connections
| # | Connected Field | Type of Connection | Depth | Key Reference |
|---|----------------|-------------------|-------|---------------|
| 1 | [field] | [shared math / analogy / method import] | [deep / promising / superficial] | [paper] |
| 2 | ... | ... | ... | ... |
## Unexplored Connections (Research Opportunities)
- [potential connection]: [why it might exist and what it could yield]
- ...
Expected: A complete, structured survey document that maps the topic from origins through current frontiers, with cross-domain connections identified and assessed.
On failure: If the survey feels disjointed, revisit the chronological timeline (Step 3) and use it as the organizing spine. Every seminal paper, open problem, and cross-domain connection should be locatable on the timeline.
formulate-quantum-problem -- formulate specific problems identified during the literature surveyderive-theoretical-result -- derive or re-derive key results found in the surveyed literaturereview-research -- evaluate individual papers encountered during the survey