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.
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.
Teams using gemini-research-subagent should expect a more consistent output, faster repeated execution, less prompt rewriting, better workflow continuity with your supporting tools.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
- You already have the supporting tools or dependencies needed by this skill.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
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.
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.
Research Proposal Generator
Generate high-quality academic research proposals for PhD applications following Nature Reviews-style academic writing conventions.
yt-research
Research competitor YouTube channels, niches, and trending topics for your content strategy. Use this skill whenever the user says "research channels", "analyze competitors", "find trending topics", "niche analysis", "competitive research", "what are other creators doing", "scrape YouTube channels", or wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.
creating-github-issues-from-web-research
This skill enhances Claude's ability to conduct web research and translate findings into actionable GitHub issues. It automates the process of extracting key information from web search results and formatting it into a well-structured issue, ready for team action. Use this skill when you need to research a topic and create a corresponding GitHub issue for tracking, collaboration, and task management. Trigger this skill by requesting Claude to "research [topic] and create a ticket" or "find [information] and generate a GitHub issue".
persona-researcher
Organize research — manage references, notes, and collaboration.
Autoresearch
Autonomous iterative experimentation loop for any programming task. Guides the user through defining goals, measurable metrics, and scope constraints, then runs an autonomous loop of code changes, testing, measuring, and keeping/discarding results. Inspired by Karpathy's autoresearch. USE FOR: autonomous improvement, iterative optimization, experiment loop, auto research, performance tuning, automated experimentation, hill climbing, try things automatically, optimize code, run experiments, autonomous coding loop. DO NOT USE FOR: one-shot tasks, simple bug fixes, code review, or tasks without a measurable metric.
Nano Banana Pro (Gemini 3 Pro Image)
Use the bundled script to generate or edit images.
apify-market-research
Analyze market conditions, geographic opportunities, pricing, consumer behavior, and product validation across Google Maps, Facebook, Instagram, Booking.com, and TripAdvisor.
../../../engineering/autoresearch-agent/skills/status/SKILL.md
No description provided.