Install to Claude Code
npx -y skills add https://github.com/evoscientist/evoskills --skill research-surveyDescription
research survey
SKILL.md
---
name: research-survey
description: "Generates structured literature survey reports from collected papers using a multi-stage pipeline: outline generation (query-type adaptive) → draft survey → section-by-section expansion → summary section refinement → final assembly. Produces survey-grade output with taxonomy-based method analysis, LaTeX formalizations, comparative tables, and dense citations. Use when: user wants a literature review, research survey, field overview, or systematic synthesis of multiple papers. Do NOT use for finding/searching papers (use paper-navigator), generating research ideas (use research-ideation), or writing a paper's Related Work section (use paper-writing)."
allowed-tools: "write_file edit_file read_file think_tool"
metadata:
author: EvoScientist
version: '1.0.0'
tags: [core, research, literature, survey, synthesis]
---
# Research Survey
Generates high-quality, survey-grade literature reviews from papers collected by `paper-navigator`.
```
paper-navigator (collect 30-120 papers)
↓
Stage 1: Generate Outline (query-type adaptive structure)
↓
Stage 2: Draft Survey (outline + top-30 papers)
↓
Stage 3: Expand Sections (draft + all papers, section-by-section)
↓
Stage 4: Generate Section Summaries
↓
Stage 5: Refine Summary Sections (Abstract/Intro/Conclusion)
↓
Stage 6: Assemble + References
```
## When to Use
- User asks for a "literature review", "survey", "field overview", or "systematic review"
- User has collected papers and wants them synthesized into a structured report
- User wants to understand the full landscape of a research field
## When NOT to Use
- **Finding papers** → use `paper-navigator` first, then come here
- **Generating research ideas** → use `research-ideation`
- **Writing a Related Work section for a paper** → use `paper-writing`
## Dependency: paper-navigator
This skill requires papers as input. If the user hasn't provided papers, **first invoke `paper-navigator`** (Workflow 1, target 30-120 papers) to collect them.
**CRITICAL: All paper discovery MUST use the `paper-navigator` skill and its scripts (scholar_search, citation_traverse, arxiv_monitor, recommend, etc.). Using WebSearch, WebFetch, or any generic web search tool for finding papers is PROHIBITED.** Generic web search cannot access Semantic Scholar, citation graphs, or academic recommendation systems. Only `paper-navigator` provides the academic search infrastructure needed for survey-quality literature collection.
---
## Stage 1: Generate Outline
**This is a two-phase process.** Different fields have different survey conventions — a clinical systematic review looks nothing like a CS methods survey. First generate a domain-appropriate template, then create the detailed outline.
### Phase 1A: Generate Domain-Specific Survey Template
Before outlining, identify the field and adapt the structure:
1. **Identify the field** from the user's goal and collected papers
2. **Select section names and organization logic** using the field-specific conventions in `assets/survey-template.md` (e.g., medicine organizes by intervention type and follows PRISMA; chemistry organizes by reaction class; social sciences organize by theoretical perspective)
3. **Add field-specific sections** (e.g., Risk of Bias Assessment for medicine, Structure-Property Relationships for materials, Ethical Considerations for human-subjects research)
4. **Determine comparison table dimensions** appropriate to the field
### Phase 1B: Create Detailed Outline
With the domain-specific template as the framework, generate the outline:
#### Query Type Classification
| Type | Example | Structure |
|------|---------|-----------|
| **A: Single-topic deep dive** | "Catalyst design for electrochemical CO2 reduction" | Intro → Problem Definition → **Methods (by mechanism/approach)** → Evaluation → Challenges → Conclusion |
| **B: Multi-topic parallel** | "Drug resistance mechanisms and therapeutic strategies in cancer immunotherapy" | Intro → **Topic 1 (definition + methods)** → **Topic 2 (definition + methods)** → Evaluation → Challenges → Conclusion |
| **C: Pipeline/stage-based** | "From sample preparation to data analysis in single-cell RNA sequencing" | Chapters organized by workflow stages |
#### Outline Requirements
The outline is NOT a simple heading list — it's a **blueprint with meta-instructions** for each section. For each `## Section`:
- Include `[Instruction: ...]` specifying what the section must contain
- Specify required tables with field-appropriate columns
- For main body sections: mandate taxonomy by underlying principle/mechanism, NOT chronology
- Include any field-required elements (e.g., PRISMA flowchart for medical systematic reviews, mathematical formalism for physics)
See `references/survey-methodology.md` for full outline generation rules and `assets/survey-template.md` for field-specific conventions.
---
## Stage 2: Draft Survey
Generate a complete draft from the outline using the **top-30 most relevant papers**.
- Use numbered citations [1], [2, 3] throughout
- Follow the outline's meta-instructions strictly
- Each methods section must build a taxonomy and include comparison tables
- Problem definition must include LaTeX formalization (`$$...$$`)
---
## Stage 3: Expand Sections
Expand each non-summary section using **all collected papers** (30-120). This is where survey-grade depth is achieved.
### Section Expansion Targets
| Section Type | Target Length | Focus |
|---|---|---|
| **Methods** | 6000+ words per paradigm chapter | Technical narratives, mechanism analysis, comparison tables |
| **Evaluation** | 3500+ words | Benchmark taxonomy, metric analysis, SOTA summary |
| **Challenges** | 3000+ words | Problem definition + evidence + opportunity per challenge |
| **Applications** | 3000+ words | Real-world use cases with specific achievements |
| **Problem Definition** | 2000+ words | LaTeX formalization, constraints, assumptions |
| **Other** | 2500+ words | Default |
### Expansion Rules
1. **Thematic coherence**: Keep same themes and narrative flow as draft — don't introduce unrelated topics
2. **Cite comprehensively**: Use as many relevant papers from the full collection as possible
3. **Survey-grade depth**: Multi-paragraph technical narratives per method family, not shallow bullet points
4. **For each paradigm/method family, include**:
- Technical narrative: How it works, theoretical assumptions, nuances between papers
- Critical analysis: Why effective, trade-offs, failure modes
- Comparative analysis table: Method | Core Mechanism | Key Advantage | Limitation | Performance
---
## Stage 4: Generate Section Summaries
After all content sections are expanded, generate a condensed summary for each major section:
1. Summarize each expanded section in 150-300 words
2. Preserve the key taxonomy, representative methods, and main trade-offs
3. Keep citation anchors so later summary sections remain grounded
These section summaries become the shared context for the final abstract, introduction, and conclusion.
---
## Stage 5: Refine Summary Sections
After all content sections are expanded, refine the **summary sections** (Abstract, Introduction, Conclusion):
1. Use all section summaries as context to rewrite Abstract, Introduction, Conclusion
2. This ensures summary sections accurately reflect the full survey content
### Summary Section Standards
**Abstract** (300-500 words):
- Continuous narrative, NO bullet points or bold labels
- Must cover: background → gap → scope → key findings → outlook
**Introduction**:
- Continuous narrative, NO subsections or bullet points
- Must cover: research background → why traditional methods fail → method summary → scope & organization
**Conclusion**:
- Summarize findings, state which paradigm is most promising
- Respond to user's original research goal
- Provide clear "next step" recommendation
---
## Stage 6: Assemble Final Survey
Assemble sections in outline order, then append formatted references:
```
**1. Title** (Year). _Authors_. *Venue*. Citations: N. [[Link]](url)
```
Save to `/artifacts/survey-{topic}-{date}.md`.
---
## Core Quality Principles
1. **Build taxonomy, don't enumerate**: Cluster papers by technical mechanism, not chronology. This is the defining characteristic of a survey vs. a summary.
2. **Critical insight over description**: For EVERY method, analyze WHY it works, WHAT trade-off it makes, WHERE it fails. This separates survey-grade writing from shallow summaries.
3. **Goal-centric filtering**: Every piece of information must answer "How does this help achieve the research goal?" Discard information that doesn't serve the goal, even if it's interesting.
4. **Strict terminology fidelity**: Use the user's exact technical terms. Do NOT drift to related but different concepts.
5. **Dense citations**: Ground ALL claims with numbered citations [X]. Nearly every sentence should reference at least one paper.
6. **Zero vagueness**: Replace generic statements with specific method names, dataset names, metric values, and problem descriptions.
7. **Visual structure**: Use Markdown tables extensively — paradigm comparison, intra-paradigm method comparison, benchmark tables, metric tables.
---
## Reference Materials
| Resource | Location | Purpose |
|----------|----------|---------|
| Multi-stage pipeline details | `references/survey-methodology.md` | Full methodology: outline rules, section standards, expansion targets |
| Section quality checklist | `references/section-quality-checklist.md` | Per-section verification checklist before finalizing |
| Survey output template | `assets/survey-template.md` | English Markdown template with section structure, table formats, and placeholder guidance |
---
## Handoff
| From → To | When |
|-----------|------|
| `paper-navigator` → here | Papers collected, user wants synthesis |
| Here → `research-ideation` | Survey reveals research gaps worth pursuing |
| Here → `paper-writing` | Survey informs Related Work section of a paper |
| Here → `paper-planning` | Survey provides literature context for story design |