gemini-research-subagent
Delegates large-context code analysis to Gemini CLI. Use when analyzing codebases, tracing bugs across files, reviewing architecture, or performing security audits. Gemini reads, Claude implements.
Best use case
gemini-research-subagent is best used when you need a repeatable AI agent workflow instead of a one-off prompt. It is especially useful for teams working in multi. Delegates large-context code analysis to Gemini CLI. Use when analyzing codebases, tracing bugs across files, reviewing architecture, or performing security audits. Gemini reads, Claude implements.
Delegates large-context code analysis to Gemini CLI. Use when analyzing codebases, tracing bugs across files, reviewing architecture, or performing security audits. Gemini reads, Claude implements.
Users should expect a more consistent workflow output, faster repeated execution, and less time spent rewriting prompts from scratch.
Practical example
Example input
Use the "gemini-research-subagent" skill to help with this workflow task. Context: Delegates large-context code analysis to Gemini CLI. Use when analyzing codebases, tracing bugs across files, reviewing architecture, or performing security audits. Gemini reads, Claude implements.
Example output
A structured workflow result with clearer steps, more consistent formatting, and an output that is easier to reuse in the next run.
When to use this skill
- Use this skill when you want a reusable workflow rather than writing the same prompt again and again.
- Use it when you already have the supporting tools or dependencies needed by the workflow.
When not to use this skill
- Do not use this when you only need a one-off answer and do not need a reusable workflow.
- Do not use it if you cannot install or maintain the related files, repository context, or supporting tools.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/gemini-research-subagent/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How gemini-research-subagent Compares
| Feature / Agent | gemini-research-subagent | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Delegates large-context code analysis to Gemini CLI. Use when analyzing codebases, tracing bugs across files, reviewing architecture, or performing security audits. Gemini reads, Claude implements.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
AI Agent for Product Research
Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.
ChatGPT vs Claude for Agent Skills
Compare ChatGPT and Claude for AI agent skills across coding, writing, research, and reusable workflow execution.
SKILL.md Source
# Gemini Research Subagent You have access to Gemini CLI as a large-context research assistant. **Use Gemini for reading large codebases, use yourself for implementation.** ## When to Invoke Gemini **ALWAYS use Gemini BEFORE:** - Reading files >100 lines - Understanding unfamiliar code areas - Tracing bugs across multiple files - Making changes that affect multiple components - Performing security or architecture reviews **DO NOT use Gemini for:** - Simple single-file edits you can handle - Writing code (that's your job) - Files you've already analyzed this session ## How to Invoke ```bash ./skills/gemini.agent.wrapper.sh -d "@src/" "Your research question" ``` ## Available Roles (loaded from `.gemini/roles/`) | Role | Command | Use Case | |------|---------|----------| | `reviewer` | `-r reviewer` | Code quality, bugs, security | | `debugger` | `-r debugger` | Bug tracing, root cause analysis | | `planner` | `-r planner` | Architecture, implementation planning | | `security` | `-r security` | Security vulnerabilities audit | | `auditor` | `-r auditor` | Codebase-wide analysis | | `explainer` | `-r explainer` | Code explanation | | `migrator` | `-r migrator` | Migration planning | | `documenter` | `-r documenter` | Documentation generation | | `dependency-mapper` | `-r dependency-mapper` | Dependency analysis | | `onboarder` | `-r onboarder` | Onboarding guide | ### Custom Roles Add custom roles in `.gemini/roles/<name>.md`. Examples: | Role | Focus | |------|-------| | `kotlin-expert` | Kotlin/Android, coroutines | | `typescript-expert` | TypeScript type safety | | `python-expert` | Python async, type hints | | `api-designer` | REST API design | | `database-expert` | Query optimization | ## Templates ```bash # Implementation-ready output ./skills/gemini.agent.wrapper.sh -t implement-ready -d "@src/" "Add user profiles" # Fix-ready output for bugs ./skills/gemini.agent.wrapper.sh -t fix-ready "Login fails with 401" # Post-implementation verification ./skills/gemini.agent.wrapper.sh -t verify --diff "Added password reset" ``` ## Response Format Gemini returns structured output you can parse: ``` ## SUMMARY [1-2 sentence overview] ## FILES [file:line references] ## ANALYSIS [detailed findings] ## RECOMMENDATIONS [actionable items] ``` ## Workflow Pattern 1. **Research**: Invoke Gemini to understand context 2. **Implement**: You write code based on Gemini's analysis 3. **Verify**: Invoke Gemini to verify your changes ## Example Usage ```bash # Pre-implementation research ./skills/gemini.agent.wrapper.sh -r planner -d "@src/" "How should I add caching?" # Post-implementation verification ./skills/gemini.agent.wrapper.sh -t verify --diff "Added caching layer" ```
Related Skills
gemini-cli
Google Gemini CLI orchestration (v0.22.0+) for AI-assisted development. Capabilities: second opinion/cross-validation, real-time Google Search grounding, codebase architecture analysis with codebase_investigator, Gemini 3 model access, extensions support (Conductor, Endor Labs), parallel code generation, code review from different perspective. INTEGRATED WITH TASK PRIMITIVE - creates traceable tasks in claude-task-viewer. Actions: query, search, analyze, generate, review with Gemini. Keywords: Gemini CLI, Gemini 3, google_web_search, codebase_investigator, second opinion, cross-validation, web research, current information, parallel AI, code review, architecture analysis, gemini prompt, AI comparison, real-time search, alternative perspective, extensions, Conductor. Use when: needing second AI opinion, searching current web information, analyzing codebase architecture, generating code in parallel, getting alternative code review, researching current events/docs, using Gemini extensions.
gemini-cli-query
Query Google Gemini models via the Gemini CLI.
gemini-cli
You are an expert in Gemini CLI, Google's open-source terminal-based AI agent powered by Gemini models. You help developers use Gemini CLI for code generation, file editing, shell command execution, and multi-modal tasks (analyzing images, reading PDFs) — with Google's 1M+ token context window for understanding entire codebases at once and MCP tool integration for extending capabilities.
collaborating-with-gemini-cli
Delegates code review, debugging, and alternative implementation comparisons to Google Gemini CLI (`gemini`) via a JSON bridge script (default model: `gemini-3-pro-preview`). Supports headless one-shot and multi-turn sessions via `SESSION_ID`, with conservative defaults for Gemini effective-context constraints (file-scoped, `--no-full-access` by default) while allowing user override.
gemini
Use when the user asks to run Gemini CLI for code review, plan review, or big context (>200k) processing. Ideal for comprehensive analysis requiring large context windows. Uses Gemini 3 Pro by default for state-of-the-art reasoning and coding.
wiki-researcher
Conducts multi-turn iterative deep research on specific topics within a codebase with zero tolerance for shallow analysis. Use when the user wants an in-depth investigation, needs to understand how something works across multiple files, or asks for comprehensive analysis of a specific system or pattern.
research-engineer
An uncompromising Academic Research Engineer. Operates with absolute scientific rigor, objective criticism, and zero flair. Focuses on theoretical correctness, formal verification, and optimal implementation across any required technology.
nerdzao-elite-gemini-high
Modo Elite Coder + UX Pixel-Perfect otimizado especificamente para Gemini 3.1 Pro High. Workflow completo com foco em qualidade máxima e eficiência de tokens.
gemini-api-dev
Use this skill when building applications with Gemini models, Gemini API, working with multimodal content (text, images, audio, video), implementing function calling, using structured outputs, or needing current model specifications. Covers SDK usage (google-genai for Python, @google/genai for JavaScript/TypeScript), model selection, and API capabilities.
context7-auto-research
Automatically fetch latest library/framework documentation for Claude Code via Context7 API
research-merge
Processes research branches from Claude Code Web sessions - merges content, moves docs to docs/research/, and creates GitHub issues. Use when /popkit:next detects research branches or when manually processing research from mobile sessions. Do NOT use for regular feature branches - only for branches matching claude/research-* or containing research documentation.
baoyu-gemini-web
Image generation skill using Gemini Web. Generates images from text prompts via Google Gemini. Also supports text generation. Use as the image generation backend for other skills like cover-image, xhs-images, article-illustrator.