← Back to Skills Marketplace
jirboy

Literature Review

by JIRBOY · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
69
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install literature-review-cn
Description
Assistance with writing literature reviews by searching for academic sources via Semantic Scholar, OpenAlex, Crossref and PubMed APIs. Use when the user need...
README (SKILL.md)

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 efetch for full XML records).
  • DOI Extraction: DOIs are extracted from all sources for cross-referencing and deduplication.
  • Automatic Deduplication: When searching multiple sources (--source all or --source both), results are automatically deduplicated by DOI.
  • Polite Access: Automatic email identification for OpenAlex/Crossref "Polite Pool" (via USER_EMAIL env var).
  • 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
USER_EMAIL Email for polite API access [email protected]
CLAWDBOT_EMAIL Fallback if USER_EMAIL not set —
SEMANTIC_SCHOLAR_API_KEY Optional S2 API key for higher rate limits —
OPENALEX_API_KEY 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 (oa): Fast and comprehensive, good abstracts.
  • Semantic Scholar (s2): High-quality citation data and TL;DRs.
  • Crossref (cr): Precise DOI-based metadata (no abstracts).
  • PubMed (pm): Gold standard for biomedical research, full abstracts and PMIDs.
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

  1. Extract: Pull key findings from the abstracts found.
  2. Organize: Group findings into a logical structure (e.g., chronological or thematic).
  3. Draft: Use the "Think step-by-step" approach to synthesize multiple sources into a coherent narrative.

Output Format

Each result includes:

  • id: Source-specific identifier (PMID for PubMed, OpenAlex ID, S2 paper ID, DOI for Crossref)
  • doi: DOI when available (used for deduplication)
  • title: Paper title
  • year: Publication year
  • authors: List of author names
  • abstract: Full abstract text (when available)
  • venue: Journal or conference name
  • citationCount: Citation count (S2, OA)
  • source: Which database the result came from

Tips for Success

  • Citations: Always cross-reference the DOI or PMID for accuracy in bibliography.
  • Filtering: Focus on papers with higher citationCount or recent years for a more modern review.
  • PubMed for Medicine: Use --source pm for the most reliable biomedical literature.
  • Deduplication: Multi-source searches automatically remove duplicates; use single sources if you need raw counts.
Usage Guidance
This skill appears to do what it says: run a Python script to query Semantic Scholar, OpenAlex, Crossref, and PubMed. Before installing or running it: (1) verify the publisher/owner and resolve the version/ownerId mismatch between the registry and the included _meta.json/SKILL.md; (2) inspect the included scripts locally (they are short and readable) to be comfortable with network calls; (3) if you provide API keys or an email, prefer throwaway or rate-limited keys and avoid reusing high-privilege credentials; (4) run the script in an isolated environment (container or VM) if you have any doubt; (5) if you need higher assurance, ask the publisher to explain the metadata/version mismatch or provide a signed release.
Capability Analysis
Type: OpenClaw Skill Name: literature-review-cn Version: 1.0.0 The skill bundle is a legitimate academic research tool designed to search and synthesize literature from Semantic Scholar, OpenAlex, Crossref, and PubMed. The Python script (scripts/lit_search.py) uses standard HTTP requests to interact with official academic APIs and includes proper deduplication logic. No evidence of malicious intent, data exfiltration, or prompt injection was found; the use of environment variables for API keys and email identification follows standard practices for these services.
Capability Tags
requires-sensitive-credentials
Capability Assessment
ℹ Purpose & Capability
The name/description (literature review via Semantic Scholar, OpenAlex, Crossref, PubMed) align with the included Python script and SKILL.md which call those APIs and perform deduplication and synthesis. However, there are packaging/metadata inconsistencies: registry metadata/version (1.0.0, owner kn7024...) differs from SKILL.md/_meta.json (version 1.2.0, owner kn70465...), and the skill lists optional env vars in SKILL.md though the registry lists 'required env vars: none'. These mismatches are not proof of maliciousness but are unexpected and should be verified with the publisher.
✓ Instruction Scope
Runtime instructions only direct the agent to run the provided script to query the declared external APIs. The script only reads a few environment variables (SEMANTIC_SCHOLAR_API_KEY, OPENALEX_API_KEY, USER_EMAIL/CLAWDBOT_EMAIL) and does not access unrelated local files, system credentials, or arbitrary endpoints. No ambiguous 'gather whatever context you need' directives are present.
✓ Install Mechanism
No install spec is provided (instruction-only plus a script file). That is low risk compared to downloadable installers. The included Python script uses the requests library but there is no automatic package installation specified.
ℹ Credentials
The script optionally uses API keys and an email for polite API usage; these env vars are proportional to the stated purpose. It does not require high-privilege or unrelated credentials. Still, be cautious before supplying any API keys or an email—use keys with limited scope and avoid sharing secrets you need elsewhere.
✓ Persistence & Privilege
The skill is not always-enabled (always: false), does not request to modify other skills, and does not persist new credentials or change system settings. It appears not to require elevated or persistent privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install literature-review-cn
  3. After installation, invoke the skill by name or use /literature-review-cn
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Version 1.2.0 adds major improvements for writing literature reviews with multi-database search support. - Now searches Semantic Scholar, OpenAlex, Crossref, and PubMed, with automatic DOI-based deduplication across sources. - Fetches full abstracts from all sources (including complete records from PubMed). - Polite API access supported via configurable email; optional API keys for higher rate limits. - Results are grouped, organized, and can be synthesized into review sections with metadata and citations. - Supports targeted, broad, and comparative searches, plus DOI-based detail retrieval.
Metadata
Slug literature-review-cn
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Literature Review?

Assistance with writing literature reviews by searching for academic sources via Semantic Scholar, OpenAlex, Crossref and PubMed APIs. Use when the user need... It is an AI Agent Skill for Claude Code / OpenClaw, with 69 downloads so far.

How do I install Literature Review?

Run "/install literature-review-cn" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Literature Review free?

Yes, Literature Review is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Literature Review support?

Literature Review is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Literature Review?

It is built and maintained by JIRBOY (@jirboy); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463942 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259883 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200739 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191401 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190375 · by oswalpalash

💬 Comments