Skip to content

claude-world/director-mode-lite / skills/handoff-gemini

handoff-gemini

Verified

Delegate long-context analysis, research, and large-document summarization to Google Gemini CLI (1M-token context) via non-interactive `gemini -p`, preserving Claude context. Use when the user says 'use gemini'/'hand off to gemini' or a task needs 100K+ tokens of context.

Handoff to Gemini CLI

Delegate tasks to Google Gemini CLI to save Claude context.


When to Use Gemini

Use Gemini ForKeep in Claude
Long document analysisComplex coding
Multimodal tasksArchitecture decisions
Research and summarizationMulti-step workflows
Large file comprehensionProblem analysis

Prerequisites

# Install Gemini CLI (Google)
npm install -g @google/gemini-cli
# Or via: https://github.com/google-gemini/gemini-cli

Handoff Process

1. Prepare Context

## Task for Gemini
**Goal**: [What needs to be done]
**Files**: [Which files to analyze]
**Output**: [What format to return]

2. Generate Command

Pass the prompt with -p (non-interactive). Reference files or directories inline with @<path>, or pipe content via stdin. There is no -f flag.

# Analyze a directory (@ reads it recursively)
gemini -p "Summarize the components in @src/"

# Research task (no file context)
gemini -p "Research best practices for [topic]"

# Document analysis (single file via @)
gemini -p "Extract key points from @docs/spec.md"

# Large or generated context via stdin
cat docs/spec.md | gemini -p "Extract key points"

Note: A src/**/*.ts-style glob only expands if the shell has globstar enabled (shopt -s globstar in bash). Prefer a directory reference like @src/, which Gemini reads recursively without relying on shell globbing.

3. Provide Instructions

  • Why Gemini is suitable
  • Expected output
  • How to continue workflow

Example

## Task: Research API Best Practices

**Command:**
gemini -p "Research REST API versioning strategies. Summarize pros/cons."

**After:**
- Review research
- Share relevant findings
- Implement chosen strategy

Benefits

  • Token Savings: Research tasks don't consume Claude context
  • Long Context: Handles very large documents
  • Specialization: Use each AI's strengths
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall