Awesome-openclaw-skills literature-review
Assistance with writing literature reviews by searching for academic sources via Semantic Scholar, OpenAlex, Crossref and PubMed APIs. Use when the user needs to find papers on a topic, get details for specific DOIs, or draft sections of a literature review with proper citations.
install
source · Clone the upstream repo
git clone https://github.com/sundial-org/awesome-openclaw-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/literature-review" ~/.claude/skills/sundial-org-awesome-openclaw-skills-literature-review && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/literature-review" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-literature-review && rm -rf "$T"
manifest:
skills/literature-review/SKILL.mdsource content
Literature Review
Help write academic literature reviews using a multi-engine search integration (S2, OA, CR, PM).
Capabilities
- Multi-Source Search: Find relevant academic papers using Semantic Scholar (S2), OpenAlex (OA), Crossref (CR), and PubMed (PM).
- Full Abstracts: All sources now return complete abstracts (PubMed uses
for full XML records).efetch - DOI Extraction: DOIs are extracted from all sources for cross-referencing and deduplication.
- Automatic Deduplication: When searching multiple sources (
or--source all
), results are automatically deduplicated by DOI.--source both - Polite Access: Automatic email identification for OpenAlex/Crossref "Polite Pool" (via
env var).USER_EMAIL - Abstract Reconstruction: Reconstructs abstracts from OpenAlex inverted index format.
- Synthesis: Group papers by theme and draft review sections based on metadata.
Environment Variables
| Variable | Purpose | Default |
|---|---|---|
| Email for polite API access | |
| Fallback if USER_EMAIL not set | — |
| Optional S2 API key for higher rate limits | — |
| Optional OpenAlex API key | — |
Workflows
1. Broad Search (All Bases)
Get a comprehensive overview from all major academic databases. Results are automatically deduplicated by DOI.
python3 scripts/lit_search.py search "impact of glycyrrhiza on bifidobacterium" --limit 5 --source all
2. Targeted Search
- OpenAlex (
): Fast and comprehensive, good abstracts.oa - Semantic Scholar (
): High-quality citation data and TL;DRs.s2 - Crossref (
): Precise DOI-based metadata (no abstracts).cr - PubMed (
): Gold standard for biomedical research, full abstracts and PMIDs.pm
python3 scripts/lit_search.py search "prebiotic effects of liquorice" --source pm
3. Comparing Sources
Search both S2 and OA simultaneously to ensure nothing is missed. Deduplicated by default.
python3 scripts/lit_search.py search "Bifidobacterium infantis growth" --source both
4. Getting Full Details (S2)
Retrieve detailed metadata including TL;DR summaries.
python3 scripts/lit_search.py details "DOI:10.1016/j.foodchem.2023.136000"
5. Writing the Review
- Extract: Pull key findings from the abstracts found.
- Organize: Group findings into a logical structure (e.g., chronological or thematic).
- Draft: Use the "Think step-by-step" approach to synthesize multiple sources into a coherent narrative.
Output Format
Each result includes:
: Source-specific identifier (PMID for PubMed, OpenAlex ID, S2 paper ID, DOI for Crossref)id
: DOI when available (used for deduplication)doi
: Paper titletitle
: Publication yearyear
: List of author namesauthors
: Full abstract text (when available)abstract
: Journal or conference namevenue
: Citation count (S2, OA)citationCount
: Which database the result came fromsource
Tips for Success
- Citations: Always cross-reference the DOI or PMID for accuracy in bibliography.
- Filtering: Focus on papers with higher
or recent years for a more modern review.citationCount - PubMed for Medicine: Use
for the most reliable biomedical literature.--source pm - Deduplication: Multi-source searches automatically remove duplicates; use single sources if you need raw counts.