gemini-cli

# Gemini CLI Skill

Use Google’s `gemini` CLI as an external “second brain” when you need a very large context window, a second opinion, or safe sandbox execution. This skill does **not** use MCP; it runs the local CLI directly.

## When To Use

Use this skill when the user asks to:

- “Ask Gemini” / “Use Gemini”
- Analyze or summarize large files or directories (especially with `@path` references)
- Brainstorm options with a specific framework (SCAMPER, design thinking, etc.)
- Generate structured edit suggestions (“change mode”) that can be applied deterministically

## Prerequisites

- `gemini` CLI is installed and configured (e.g. `gemini --version` works)
- You are allowed to run local shell commands in this environment
- For sandbox execution, Gemini CLI supports `-s/--sandbox` (see `gemini --help`)

## Core Commands

### One-shot query (plain)

```bash
gemini "Explain what this code does: @src/main.ts"
```

### Choose a model

```bash
gemini -m gemini-2.5-pro "..."
gemini -m gemini-2.5-flash "..."
```

### Sandbox mode

```bash
gemini -s "Safely test @scripts/example.py and explain the results."
```

## Helper Script (Recommended)

This skill ships with a dependency-free wrapper that mirrors the core behavior of `gemini-mcp-tool` without MCP:

`skills/gemini-cli/scripts/gemini-tool.mjs`

Important: Gemini CLI can only read files under its current “project directory” (typically the process working directory). Run the wrapper from the repo you want Gemini to read, or pass `--cwd`.

```bash
node skills/gemini-cli/scripts/gemini-tool.mjs help
```

### Ask Gemini (wrapper)

```bash
node skills/gemini-cli/scripts/gemini-tool.mjs ask --prompt "Summarize @. in 5 bullets."
node skills/gemini-cli/scripts/gemini-tool.mjs ask --cwd /path/to/project --prompt "Summarize @. in 5 bullets."
node skills/gemini-cli/scripts/gemini-tool.mjs ask --prompt "..." --model gemini-2.5-pro
node skills/gemini-cli/scripts/gemini-tool.mjs ask --prompt "..." --sandbox
```

### Brainstorm (wr