gemini-cli

# Gemini CLI Skill (No MCP)

A standalone Agent Skill that teaches coding agents how to use the local `gemini` CLI for:

- Large-context analysis (including `@file` / `@dir` references supported by Gemini CLI)
- Sandbox execution (`-s`)
- Structured “change mode” edit suggestions (with chunking + cache to handle long outputs)
- Brainstorming prompts

Skills follow the [Agent Skills](https://agentskills.io/) format.

## Available Skills

### gemini-cli

Use Gemini CLI for second opinions, large-context `@path` analysis, sandbox runs, and structured change-mode edits.

## Installation (Recommended)

This repo is designed to be installed with Vercel’s `add-skill` CLI:

```bash
npx add-skill X-Zero-L/gemini-cli-skill
```

Examples:

```bash
# List skills in this repository
npx add-skill X-Zero-L/gemini-cli-skill --list

# Install only this skill
npx add-skill X-Zero-L/gemini-cli-skill --skill gemini-cli

# Install globally to Codex + Claude Code (no prompts)
npx add-skill X-Zero-L/gemini-cli-skill --skill gemini-cli -g -a codex -a claude-code -y
```

## Repository Layout

- `skills/gemini-cli/SKILL.md`: the skill instructions + examples
- `skills/gemini-cli/scripts/gemini-tool.mjs`: helper wrapper around `gemini` CLI (no dependencies)

## Quick Smoke Test

```bash
git clone https://github.com/X-Zero-L/gemini-cli-skill
cd gemini-cli-skill

node skills/gemini-cli/scripts/gemini-tool.mjs ask --prompt "Say OK only."
node skills/gemini-cli/scripts/gemini-tool.mjs ask --prompt "@README.md Summarize this file in 3 bullets."
```