gemini

Installation
Summary

Comprehensive code review and large-context analysis using Gemini 3 Pro with flexible approval modes.

  • Supports five Gemini models ranging from flagship reasoning (Gemini 3 Pro) to cost-optimized alternatives, with 1M token input windows for analyzing entire codebases and documentation sets
  • Three approval modes: default for interactive terminal prompts, auto_edit for auto-approving code suggestions, and yolo for fully automated background execution
  • Critical safety requirement: use --approval-mode yolo or timeout wrapper in non-interactive shells to prevent indefinite hangs waiting for approval prompts
  • Designed for code reviews, architectural plan analysis, multi-file pattern detection, and tasks exceeding 200k tokens of context
SKILL.md

Gemini Skill Guide

When to Use Gemini

  • WHEN ASKED TO BE ACTIVATED
  • Code Review: Comprehensive code reviews across multiple files
  • Plan Review: Analyzing architectural plans, technical specifications, or project roadmaps
  • Big Context Processing: Tasks requiring >200k tokens of context (entire codebases, documentation sets)
  • Multi-file Analysis: Understanding relationships and patterns across many files

⚠️ Critical: Background/Non-Interactive Mode Warning

NEVER use --approval-mode default in background or non-interactive shells (like Claude Code tool calls). It will hang indefinitely waiting for approval prompts that cannot be provided.

For automated/background reviews:

  • ✅ Use --approval-mode yolo for fully automated execution
  • ✅ OR wrap with timeout: timeout 300 gemini ...
  • ❌ NEVER use --approval-mode default without interactive terminal

Symptoms of hung Gemini:

Related skills

More from softaworks/agent-toolkit

Installs
3.6K
GitHub Stars
1.8K
First Seen
Jan 20, 2026