CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A high-quality instruction skill: executable commands throughout, explicit validation and feedback loops, appropriate single-reference disclosure, and no padding. The sole deduction is inline version-pinned defaults that will age, though the skill partially mitigates this by deferring to the binary's --help and live model catalog.

Suggestions

Move version-pinned values (default model names, '-m gemini-3.1-flash-lite as of 0.4.5', the dated deep-research agent ID) into references/cli.md, which already states the verified CLI version, and keep SKILL.md pointing at the live catalog ('gemini-api models') instead.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no concept explanations, dense command tables, every line actionable — but it embeds time-sensitive version pins inline ("-m gemini-3.1-flash-lite as of 0.4.5", "deep-research-preview-04-2026", dated default model names) rather than confining them to a versioned/deprecated section, which the guidelines penalize. It is noticeably above the mostly-efficient 3 anchor but short of the every-token-earns-its-place 5 anchor.

4 / 5

Actionability

Fully executable, copy-paste-ready commands cover the common cases: the background-agent snippet ("ID=$(gemini-api agent run ... --agent deep-research-preview-04-2026 --background --jq '.id')"), file-path capture ("MASCOT=$(gemini-api image ... --out ./assets/mascot.jpg)"), the complete --jq extraction pipeline, exact flags (--stream=false -o json), and enumerated exit codes with branching guidance.

5 / 5

Workflow Clarity

Sequencing is explicit ("Preflight (once per session, before the first call)"), validation checkpoints are built in (--dry-run "Validate before spending a call", whoami key check), and error-recovery feedback loops are stated ("When a flag in this skill is rejected, trust the binary: run --help on that command and adapt"; branch on exit codes 0/1/2/3). Destructive server-side operations carry explicit user-confirmation requirements, so no cap applies.

5 / 5

Progressive Disclosure

The body is a well-organized overview that clearly signals exactly one one-level-deep reference ("Verified command details, output shapes, and gotchas: `references/cli.md`"). The reference file exists, contains no nested .md references, and the split is appropriate: judgment and gotchas in SKILL.md, command detail in the reference.

5 / 5

Total

19

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: third-person, concrete capability enumeration, explicit use-when and trigger lists, and a negative boundary. The only soft spot is that a few generic trigger phrases ('generate an image', 'make a voiceover') could collide with sibling media-generation skills in the same collection.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities spanning the CLI's full command surface — "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" — matching the comprehensive-coverage anchor rather than the 4 anchor, which allows coverage gaps.

5 / 5

Completeness

It explicitly answers both what ("Call the Gemini API from the shell with Google's `gemini-api` CLI..." plus the capability list) and when ("Use when the task needs a Gemini model or a second opinion...", reinforced by an explicit Triggers list), and adds a negative boundary ("Not for writing application code against the Gemini SDK or Vertex AI"). This is the 5 anchor verbatim in structure.

5 / 5

Trigger Term Quality

Natural user phrasing is comprehensively covered with synonyms and artifact terms: "'use gemini', 'ask gemini', 'gemini-api', 'generate an image', 'make a voiceover', 'transcribe this', 'analyze this PDF', 'deep research'" plus PDF/recording/SRT in the when-clause. No 4-level gap of missing natural terms is evident.

5 / 5

Distinctiveness Conflict Risk

Scoping to "when that binary is installed" and the explicit SDK/Vertex AI exclusion make it mostly distinct, but generic triggers like 'generate an image' and 'make a voiceover' overlap with the dedicated imagen and google-tts/elevenlabs skills the body itself names. It fits the 4 anchor (minor overlap with closely related skills) rather than 5 (minimal conflict risk).

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

sanjay3290/ai-skills

Path

skills/gemini-api/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.