# collaborating-with-gemini

collaborating-with-gemini connects Gemini CLI as a second opinion for diff inspection, bug analysis, and prototyping via a Python bridge.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 475 repo stars
- Author: cnfjlhj
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cnfjlhj/ai-collab-playbook/tree/HEAD/skills/full/collaborating-with-gemini/SKILL.md
- Updated: 2026-10-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/collaborating-with-gemini

## What it does

This skill connects your workspace agent to Gemini CLI using `scripts/gemini_bridge.py`. The bridge wrapper emits structured JSON and maintains multi-turn dialogs by tracking `SESSION_ID` across subsequent calls. That lets you ask follow-up questions without restarting conversation context from scratch.

Prompts reference file paths and line ranges instead of dumping raw code blocks into terminal arguments. The bridge takes `--cd` pointing to the repository root. For suggested edits, the instructions demand output strictly as a Unified Diff Patch and prohibit touching source files directly. Optional arguments include `--model`, `--sandbox`, and `--return-all-messages`.

Execution relies on Python 3 and a functional Gemini CLI installation. When sharing UI snapshots, store PNG files in `.codex_uploads/` rather than the system temp directory, because Gemini refuses to inspect files outside the active workspace root.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill collaborating-with-gemini -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/collaborating-with-gemini/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/collaborating-with-gemini/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill collaborating-with-gemini -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/collaborating-with-gemini/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill collaborating-with-gemini -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/collaborating-with-gemini/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cnfjlhj/ai-collab-playbook skills/full/collaborating-with-gemini
```

2. **Manually: put the files in place**
- File: `.github/skills/collaborating-with-gemini/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill collaborating-with-gemini -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cnfjlhj/ai-collab-playbook --path skills/full/collaborating-with-gemini
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/collaborating-with-gemini/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cnfjlhj/ai-collab-playbook/tree/HEAD/skills/full/collaborating-with-gemini/SKILL.md

## When to use it
- gather a second perspective on tricky edge cases and logic bugs
- review proposed patch risks before committing code changes
- continue multi-turn troubleshooting conversations via SESSION_ID
- evaluate UI readability and design alternatives safely

## Example prompts
- Run gemini_bridge.py to ask Gemini CLI for edge cases in src/auth.py around login()
- Continue the Gemini session with SESSION_ID and request a fix strictly as a Unified Diff Patch
- Pass the image inside .codex_uploads/ to Gemini CLI to review the updated layout

## Similar
- [gemini](https://affpapa.org/en/nevibecode/skills/softaworks-gemini.md) — skill · 4000 installs
- [gemini-agents](https://affpapa.org/en/nevibecode/skills/gemini-agents.md) — skill · ★ 741 repo stars
- [gemini-review](https://affpapa.org/en/nevibecode/commands/gemini-review.md) — command · 217 installs
- [gemini-api-dev](https://affpapa.org/en/nevibecode/skills/gemini-api-dev.md) — skill · 27800 installs
- [gemini-computer-use](https://affpapa.org/en/nevibecode/skills/gemini-computer-use.md) — skill · 1200 installs
- [gemini-omni-flash-api](https://affpapa.org/en/nevibecode/skills/gemini-omni-flash-api.md) — skill · 2500 installs

From the same set: [cnfjlhj/ai-collab-playbook](https://affpapa.org/en/nevibecode/by/cnfjlhj/ai-collab-playbook.md) — 18 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
