gemini-search
Search research papers via Gemini for broad literature discovery. Use when user says "gemini search", "gemini papers", "search with gemini", or wants AI-powered literature discovery beyond arXiv/Semantic Scholar indexes.
- License 许可
- MIT
- 最近更新
- 2026-10-22
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- gemini-search
- description
- Search research papers via Gemini for broad literature discovery. Use when user says "gemini search", "gemini papers", "search with gemini", or wants AI-powered literature discovery beyond arXiv/Semantic Scholar indexes.
- allowed-tools
- Bash(*), Read, Write, mcp__gemini-cli__*
- argument-hint
- [search-query]
03 SKILL.md 正文
Gemini Literature Search
Search query: $ARGUMENTS
Role & Positioning
This skill uses Gemini as a broad literature discovery source:
| Skill | Source | Best for |
|---|---|---|
/arxiv |
arXiv API | Latest preprints, cutting-edge unrefereed work |
/semantic-scholar |
Semantic Scholar API | Published venue papers (IEEE, ACM, Springer) with citation counts |
/deepxiv |
DeepXiv CLI | Layered reading: search, brief, section map, section reads |
/exa-search |
Exa API | Broad web search: blogs, docs, news, companies, research papers |
/gemini-search |
Gemini MCP / CLI | AI-powered broad literature discovery — searches across multiple angles, aliases, and sub-problems |
Use Gemini when you want AI-driven discovery that goes beyond keyword matching — Gemini decomposes topics into sub-problems, explores naming variants, and surfaces papers that traditional API searches may miss.
Constants
- MAX_RESULTS = 15 — Target number of papers Gemini should find.
- MIN_YEAR = 2022 — Default minimum publication year. Override with
— year: 2020-. - DEFAULT_MODEL = auto-gemini-3 — Auto-routes within the Gemini 3 family (Pro / Flash) by server-side capacity. Required by
mcp__gemini-cli__ask-geminiandgemini-cliv0.40+; explicitgemini-3-pro-previewis silently downgraded togemini-2.5-proon OAuth-personal / Google One AI Pro accounts when capacity is exhausted. Override with— model: gemini-3-flash-preview(Gemini 3 Flash explicit, faster, higher quota), or— model: gemini-2.5-pro/gemini-2.5-flash(legacy, only for users on oldergemini-cli< v0.40). The MCP tool accepts all of these verbatim.
Overrides (append to arguments):
/gemini-search "topic" — max: 20— request up to 20 papers/gemini-search "topic" — year: 2020-— papers from 2020 onward/gemini-search "topic" — code-only— only papers with open-source code/gemini-search "topic" — venues: NeurIPS,ICML,ICLR— focus on specific venues/gemini-search "topic" — model: gemini-3-flash-preview— Gemini 3 Flash (faster, higher quota, less capable than Pro)/gemini-search "topic" — model: auto-gemini-3— auto-routes within the Gemini 3 family by load/gemini-search "topic" — model: gemini-2.5-pro— legacy (only if yourgemini-cli< v0.40)
Environment & Setup
Prerequisites
- Node.js v16.0.0+
- Google Gemini CLI — installed and authenticated
npm install -g @google/gemini-cli gemini auth - gemini-mcp-tool — MCP bridge for Claude Code (jamubc/gemini-mcp-tool)
npm install -g gemini-mcp-tool
MCP Configuration
In ~/.claude.json (or %APPDATA%\Claude\claude_desktop_config.json for Claude Desktop), add:
{
"mcpServers": {
"gemini-cli": {
"command": "gemini-mcp"
}
}
}
Alternative via npx (auto-install):
{
"mcpServers": {
"gemini-cli": {
"command": "npx",
"args": ["-y", "gemini-mcp-tool"]
}
}
}
Or one-line setup:
claude mcp add gemini-cli -- npx -y gemini-mcp-tool
Authentication
Gemini CLI uses your Google account or an API key. Add to .claude/.env:
# .claude/.env
GEMINI_API_KEY=your-key-here
Claude Code automatically loads .claude/.env as environment variables.
- Free key from Google AI Studio
- Flash model (
gemini-2.5-flash) has a generous free tier (500 req/min)
Available MCP Tools
| Tool | Parameters | Description |
|---|---|---|
mcp__gemini-cli__ask-gemini |
prompt (required), model (optional), sandbox (optional) |
Ask Gemini for analysis or research; supports @file syntax |
mcp__gemini-cli__sandbox-test |
prompt (required), model (optional) |
Safe code execution in sandbox |
mcp__gemini-cli__ping |
— | Connection test |
mcp__gemini-cli__help |
— | Show Gemini CLI help |
Verify Setup
gemini --version
Workflow
Step 1: Parse Arguments
Parse $ARGUMENTS for:
- query: The research topic (required)
- max: Override MAX_RESULTS
- year: Minimum publication year (e.g.,
2020-) - code-only: Only include papers with open-source code
- venues: Comma-separated venue filter
- model: Override DEFAULT_MODEL
Step 2: Execute Search (MCP Priority)
Priority 1 — Gemini MCP (preferred):
Try calling mcp__gemini-cli__ask-gemini with the search prompt:
mcp__gemini-cli__ask-gemini({
prompt: 'You are a research literature scout. Search comprehensively for papers on: "QUERY"
IMPORTANT CONSTRAINTS:
1. Search from MULTIPLE angles — do not just use the exact query. Decompose the topic into sub-problems, aliases, neighboring tasks, and common benchmark/settings variants.
2. Prefer papers that are genuinely relevant, not merely keyword-adjacent.
3. Include top venues, journals, surveys, recent preprints, and papers with code when available.
4. Focus on papers from MIN_YEAR onward unless older foundational work is necessary.
For EACH paper found, provide ALL of the following in this exact format:
- Title: [exact title]
- Authors: [full author list]
- Year: [publication year]
- Venue: [exact conference/journal name + year, or "arXiv preprint" if not published]
- arXiv ID: [format 2401.12345, or "N/A"]
- DOI: [if available, or "N/A"]
- Code URL: [GitHub/GitLab link if available, or "No code"]
- Summary: [one-sentence core contribution]
Find at least MAX_RESULTS papers with good coverage across:
- strong recent papers from top venues
- surveys/reviews if they exist
- papers with open-source code
- closely related variants of the topic
Format as a numbered list with all fields for each paper.',
model: 'auto-gemini-3'
})
Priority 2 — Gemini CLI fallback (if MCP unavailable):
If mcp__gemini-cli__ask-gemini fails or is not configured, fall back to CLI:
gemini -p 'You are a research literature scout. Search comprehensively for papers on: "QUERY"
...same prompt as above...' 2>/dev/null
- Timeout: 120 seconds
- Stderr: Pipe to
/dev/null— contains hook warnings, not part of the response
When to use which:
- MCP is preferred because it integrates natively with Claude Code's tool system, handles model selection, and avoids shell escaping issues.
- CLI fallback ensures the skill works even when MCP is not configured or the MCP server process has crashed.
Step 3: Parse Results
Extract structured paper information from Gemini's response. For each paper, normalize to:
{
title, authors, year, venue,
arxiv_id, // "N/A" if not available
doi, // "N/A" if not available
code_url, // "No code" if not available
summary // one-sentence contribution
}
If Gemini returns fewer papers than requested, note this but do not re-query.
Step 4: Present Results
Format results as a structured table:
| # | Title | Venue | Year | Code | Summary |
|---|-------|-------|------|------|---------|
| 1 | ... | NeurIPS 2024 | 2024 | [GitHub](url) | ... |
| 2 | ... | IEEE TWC | 2023 | No | ... |
For each paper, also show:
- arXiv ID: if available (for cross-reference with
/arxiv) - DOI: if available (canonical link for published papers)
- Code: GitHub/GitLab link or "No"
Step 5: Offer Follow-up
After presenting results, suggest:
/semantic-scholar "topic" — search published venue papers with citation counts
/arxiv "arXiv:XXXX.XXXXX" — fetch specific preprint details
/research-lit "topic" — sources: gemini, semantic-scholar — combined multi-source review
/novelty-check "idea" — verify novelty against literature
Key Rules
- MCP first, CLI second. Always try
mcp__gemini-cli__ask-geminibefore falling back togemini -p. - Gemini is a discovery source, not a database. Its results may include papers it "knows about" from training data. Always cross-verify critical details (exact titles, venues, years) via
/semantic-scholaror/arxivwhen precision matters. - Do not use Gemini for citation counts. It may hallucinate citation numbers. Use Semantic Scholar for authoritative citation data.
- Pipe stderr to
/dev/nullin CLI mode — Gemini CLI emits hook warnings on stderr. - Timeout generously in CLI mode — Gemini's thorough search can take 30-60 seconds. Set timeout to 120s.
- If both MCP and CLI are unreachable, suggest using
/semantic-scholar,/arxiv, or/research-lit "topic" — sources: webas alternatives.
04 同仓库更多 Skills
bio-free-energy-calculations
Performs alchemical free-energy calculations including relative binding free energy (RBFE / FEP+) and absolute binding free energy (ABFE) via OpenFE, FEP+, GROMACS, AMBER pmemd, and OpenMM with explicit lambda scheduling, soft-core potentials, MBAR/BAR analysis, cycle-closure validation, and protocol-appropriate enhanced sampling. Compares ML alternatives (Boltz-2 affinity, DeepDock). Use when ranking analogs by binding affinity beyond docking accuracy, performing prospective lead optimization, or validating SAR predictions.
bio-conformer-generation
Generates 3D conformer ensembles using RDKit ETKDGv3 with knowledge-enhanced distance geometry, MMFF94/UFF force-field optimization, CREST + GFN2-xTB semi-empirical refinement, and macrocycle-aware torsion preferences. Provides explicit decision rules for single vs ensemble conformer use, RMSD pruning, energy windows, conformer count, and force-field choice. Use when preparing 3D ligands for docking, generating descriptor input for 3D QSAR, or sampling macrocycle/peptide conformational ensembles.
bio-admet-prediction
Predicts ADMET properties using ADMETlab 3.0 (119 platform features, including 77 prediction models with modeled-endpoint uncertainty), ADMET-AI, DeepChem MolNet, and chemprop D-MPNN with explicit handling of OECD QSAR principles, applicability domain assessment, calibration, hERG/CYP/AMES endpoints, and PAINS / Lipinski / Ro5 / Veber / BBB druglikeness filters. Use when filtering compounds for drug-likeness, prioritizing leads by predicted safety, or building an in-house ADMET QSAR model.
writing-systems-papers
Paragraph-level structural blueprint for 10-12 page systems papers targeting OSDI, SOSP, ASPLOS, NSDI, and EuroSys. Provides page allocation, paragraph templates, and writing patterns. Use when user says "写系统论文", "systems paper structure", "OSDI paper", "SOSP paper", or wants fine-grained structural guidance for a systems conference submission.
wiki-enrich
Fill in the per-paper TODO sections of research-wiki/papers/<slug>.md pages that literature-ingest skills leave as bare scaffolds. Use when user says 'enrich wiki', 'fill paper TODOs', 'wiki body 補完', '把 paper 摘要寫進 wiki', 'research-wiki 自動填', or after a batch ingest that left papers/ as TODO scaffolds.
web-debug-search
Search GitHub, Stack Exchange, Chinese technical communities, official documentation, and general developer web sources for software errors, compatibility problems, API usage questions, and real-world workarounds. Use for debugging and discovery only; results are not paper-citation evidence.