Individual skill

gemini-api

Call the Gemini API from the shell with Google's `gemini-api` CLI, when that binary is installed — text and reasoning, image generation and editing, text-to-speech, music, video, document/audio/video/YouTube analysis, transcription and captions, file uploads, and managed agents (Deep Research) run in the background. Use when the task needs a Gemini model or a second opinion from one, a generated image/voiceover/soundtrack/clip, an answer out of a PDF or recording, an SRT caption file, or a long-running research agent. Triggers: 'use gemini', 'ask gemini', 'gemini-api', 'generate an image', 'make a voiceover', 'transcribe this', 'analyze this PDF', 'deep research'. Not for writing application code against the Gemini SDK or Vertex AI.

skills/gemini-api/SKILL.md

Read pinned source

Source commit c84255839a1bfaa06d681aa528f9b50d70002afb

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
Yes
Repository scan complete
No
Skill scan complete
No
Observed behavior
Network or broad shell
Last checked
Nov 10, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings)
454
Repository last updated
Nov 2, 2026
License
Apache-2.0

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt

# Gemini API from the shell

`gemini-api` is Google's single-binary CLI for the Gemini Interactions API. Each
invocation does one thing and returns either text on stdout or a file path on disk.

Verified command details, output shapes, and gotchas: `references/cli.md`.

## Preflight (once per session, before the first call)

`gemini-api whoami` prints the config file, the credential source, and the active
defaults. If it reports no API key, stop and ask the user to set one — never guess at a
key or edit their config. The persistent form is `gemini-api configure --api-key "..."`,
which writes to the OS keychain; `GEMINI_API_KEY` in the environment also works.
Back to top