Agent skill

gemini-headless

Delegiere Aufgaben an Gemini CLI im Headless-Mode. Nutze fuer Dokumentation, Code-Reviews, Analysen oder wenn der User /gemini aufruft. Nutzt Google Subscription (KEIN API Key). Auto-Accept mit -y Flag.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/gemini-headless

SKILL.md

Gemini Headless Mode

Overview

Dieser Skill ermoeglicht die Nutzung von Gemini CLI fuer delegierbare Aufgaben. Gemini laeuft im Headless-Mode mit -y Flag (keine Bestaetigungen).

WICHTIG: Nutzt Google Subscription (Gemini Advanced), KEINEN API Key!

Quick Start

bash
gemini -y -p "Deine Aufgabe hier"

Authentifizierung (Subscription)

IMMER Google Login nutzen (Subscription), NIEMALS API Key!

bash
# Erster Login (einmalig, oeffnet Browser)
gemini login

# Status pruefen
gemini auth status

Nach dem Login ist die Subscription aktiv und es werden keine API-Kosten berechnet.

Core Instructions

Wann Gemini nutzen

  • Dokumentationserstellung (.md, README, etc.)
  • Code-Reviews und Analysen
  • Textgenerierung und Zusammenfassungen
  • Wenn der User explizit /gemini aufruft

Standard-Workflow

  1. Aufgabe verstehen: Was soll Gemini tun?
  2. Kontext sammeln: Relevante Dateien identifizieren
  3. Prompt konstruieren: Aufgabe + Kontext zusammenfuehren
  4. Gemini ausfuehren: Via Bash mit -y Flag
  5. Output verarbeiten: Ergebnis in Datei schreiben/anzeigen

Bash-Commands

Einfache Aufgabe:

bash
gemini -y -p "Erstelle eine README.md fuer dieses Projekt"

Mit Datei-Kontext (via Stdin):

bash
cat src/main.ts | gemini -y -p "Erklaere diesen Code und erstelle Dokumentation"

Mit Verzeichnis-Kontext:

bash
gemini -y -p "Analysiere die Architektur" --include-directories ./src,./docs

Output in Datei speichern:

bash
gemini -y -p "Erstelle eine API-Dokumentation" > docs/api.md

Mehrere Dateien als Kontext:

bash
cat file1.ts file2.ts | gemini -y -p "Vergleiche diese Implementierungen"

Examples

Beispiel 1: README erstellen

bash
cat CLAUDE.md package.json | gemini -y -p "Erstelle eine kurze README.md fuer dieses Projekt. Fokus auf Installation und Quick Start."

Beispiel 2: Code dokumentieren

bash
cat src/services/auth.service.ts | gemini -y -p "Erstelle JSDoc Kommentare fuer alle oeffentlichen Methoden"

Beispiel 3: Code-Review

bash
git diff HEAD~1 | gemini -y -p "Review diese Aenderungen. Finde Bugs, Security-Issues, Best-Practice-Verstoesse"

Beispiel 4: Context-Datei generieren

bash
gemini -y -p "Erstelle eine context.md Datei die das Projekt beschreibt" --include-directories ./src

Wichtige Flags

Flag Beschreibung
-y PFLICHT - Auto-Accept aller Aktionen
-p "..." PFLICHT - Prompt im Headless-Mode
--include-directories Verzeichnisse als Kontext
-m gemini-2.5-flash Schnelleres Modell (optional)
--output-format json Fuer programmatisches Parsing

Installation

bash
npm install -g @google/gemini-cli
# oder
brew install gemini-cli

WICHTIG: Keine API Keys!

FALSCH (API Key):

bash
# NICHT VERWENDEN!
export GOOGLE_API_KEY="..."

RICHTIG (Subscription):

bash
# Google Login nutzen
gemini login

Didn't find tool you were looking for?

Be as detailed as possible for better results