survey generation
- Repo stars 90
- Author repo agent-research-skills
- Domain
- Writing
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @lingzhi227 · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- Python
- Detected file/system behavior
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
Search Semantic Scholar / arXiv for papers on the topic Collect 50-200 relevant papers with titles and abstracts Filter by relevance and citation count
Generate N rough outlines independently (parallel) Merge outlines into a single comprehensive outline Expand each section into subsections Edit final outline to remove redundancies
For each subsection: Retrieve relevant papers for the subsection topic Generate content with inline citations `[paper_title]` Enforce minimum word count per subsection Only cite papers from the provided list
For each subsection: Check that cited paper titles are correct Verify citations support the claims made Remove or correct unsupported citations Use NLI (Natural Language Inference) for claim-source faithfulness
For each subsection: Read previous and following subsections Refine transitions and flow Preserve core content and citations Ensure smooth reading experience
Replace `[paper_title]` with `\cite{key}` Generate BibTeX entries for all cited papers Validate all citation keys exist in .bib file
# Survey Generation
Generate complete academic survey papers with structured outline, RAG-based writing, and citation validation.
## Input
- `$0` — Survey topic or research area
## Scripts
### Literature search
```bash
python ~/.claude/skills/deep-research/scripts/search_semantic_scholar.py \
--query "relevant search query" --max-results 50
```
## References
- Survey prompts (outline, writing, citation, coherence): `~/.claude/skills/survey-generation/references/survey-prompts.md`
## Workflow (from AutoSurvey)
### Step 1: Collect Papers
1. Search Semantic Scholar / arXiv for papers on the topic
2. Collect 50-200 relevant papers with titles and abstracts
3. Filter by relevance and citation count
### Step 2: Generate Outline (Multi-LLM Parallel)
1. Generate N rough outlines independently (parallel)
2. Merge outlines into a single comprehensive outline
3. Expand each section into subsections
4. Edit final outline to remove redundancies
### Step 3: Write Subsections (RAG-Based)
For each subsection:
1. Retrieve relevant papers for the subsection topic
2. Generate content with inline citations `[paper_title]`
3. Enforce minimum word count per subsection
4. Only cite papers from the provided list
### Step 4: Validate Citations
For each subsection:
1. Check that cited paper titles are correct
2. Verify citations support the claims made
3. Remove or correct unsupported citations
4. Use NLI (Natural Language Inference) for claim-source faithfulness
### Step 5: Enhance Local Coherence
For each subsection:
1. Read previous and following subsections
2. Refine transitions and flow
3. Preserve core content and citations
4. Ensure smooth reading experience
### Step 6: Convert Citations to BibTeX
1. Replace `[paper_title]` with `\cite{key}`
2. Generate BibTeX entries for all cited papers
3. Validate all citation keys exist in .bib file
## Output Structure
```
survey/
├── main.tex # Complete survey paper
├── references.bib # All citations
├── outline.json # Survey outline
└── sections/ # Individual section files
```
## Rules
- Only cite papers from the collected paper list — never hallucinate citations
- Each subsection must meet minimum word count
- No duplicate subsections across sections
- Citation validation is mandatory before final output
- Local coherence enhancement must preserve all citations
- The survey should be comprehensive and logically organized
## Related Skills
- Upstream: [deep-research](../deep-research/), [literature-search](../literature-search/), [literature-review](../literature-review/)
- See also: [related-work-writing](../related-work-writing/)
Listed in source order.
sections -> Input → Scripts → Literature search → References → Workflow (from AutoSurvey) → Step 1: Collect Papers
terms -> Generate complete academic survey papers with structured outline, RAG-based writing, and citation validation.
files/cmd -> ~/.claude/skills/survey-generation/references/survey-prompts.md · [paper_title] · \cite{key} · .claude/skills/deep-research/scripts/search_semantic_scholar.py · .claude/skills/survey-generation/references/survey-prompts.md · outline.js · ../deep-research · ../literature-search
body sha256 -> 66a169fa69cc
Input
$0— Survey topic or research areaReferences
Survey prompts (outline, writing, citation, coherence):
~/.claude/skills/survey-generation/references/survey-prompts.mdStep 1: Collect Papers
Search Semantic Scholar / arXiv for papers on the topic Collect 50-200 relevant papers with titles and abstracts Filter by relevance and citation count
Step 2: Generate Outline (Multi-LLM Parallel)
Generate N rough outlines independently (parallel) Merge outlines into a single comprehensive outline Expand each section into subsections Edit final outline to remove redundancies
Step 3: Write Subsections (RAG-Based)
For each subsection: Retrieve relevant papers for the subsection topic Generate content with inline citations
[paper_title]Enforce minimum word count per subsection Only cite papers from the provided list