How do I install the Gemini Headless skill?

Run npx skillmds@latest add majiayu000/gemini-headless in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gemini Headless safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gemini Headless?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gemini Headless free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gemini Headless?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gemini Headless by majiayu000 — Agent Skill

Name: Gemini Headless
Rating: 4.5 (4 reviews)
Author: majiayu000

File contents

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

gemini -y -p "Deine Aufgabe hier"

Authentifizierung (Subscription)

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

# 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

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

Bash-Commands

Einfache Aufgabe:

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

Mit Datei-Kontext (via Stdin):

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

Mit Verzeichnis-Kontext:

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

Output in Datei speichern:

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

Mehrere Dateien als Kontext:

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

Examples

Beispiel 1: README erstellen

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

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

Beispiel 3: Code-Review

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

Beispiel 4: Context-Datei generieren

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

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

WICHTIG: Keine API Keys!

FALSCH (API Key):

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

RICHTIG (Subscription):

# Google Login nutzen
gemini login

---name: gemini-headlessdescription: 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.--- # 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 ```

Frequently asked questions

Gemini Headless