name: gemini-research-subagent description: 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. dependencies:

• gemini-cli

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

./skills/gemini.agent.wrapper.sh -d "@src/" "Your research question"

Available Roles (loaded from .gemini/roles/)

Custom Roles

Add custom roles in .gemini/roles/<name>.md. Examples:

Templates

# 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

# 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"