gemini-headless

Delegate documentation, code reviews, and analyses to the Gemini CLI in headless mode.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/StefanMaksimek/dev-challenge-2026 --skill gemini-headless
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gemini-headless
Source: https://github.com/StefanMaksimek/dev-challenge-2026/tree/main/.claude/skills/gemini-headless
Command: npx skills add https://github.com/StefanMaksimek/dev-challenge-2026 --skill gemini-headless

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables delegating documentation, code reviews, and analyses to the Gemini CLI in headless mode using a Google Subscription (no API key). It streamlines repetitive knowledge-work by offloading tasks to an automated assistant.

Core Features & Use Cases

  • Headless delegation: Run Gemini with -y to auto-accept prompts for background task execution (docs, reviews, and analyses).
  • Context-driven prompts: Feed relevant files and directories to Gemini to generate documentation, summaries, or code insights.
  • Use Case: When you need a quick API docs draft or a code review note, invoke Gemini headless to produce the output without interactive confirmations.

Quick Start

gemini -y -p "Create a concise API documentation for this project"

Frequently Asked Questions about gemini-headless

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate code reviews without interactive confirmations?

To automate code reviews without interactive confirmations, you can delegate tasks to the Gemini CLI in headless mode, which uses the -y flag to auto-accept prompts and run background execution seamlessly.

Can I use my Google Subscription to generate API documentation instead of an API key?

Yes, you can use your existing Google Subscription for API documentation generation via the Gemini CLI, entirely bypassing the need to configure or manage a separate API key.

How do I run Gemini headlessly to analyze project files?

You run Gemini headlessly to analyze project files by invoking the CLI with the -y and -p flags, passing context-driven prompts that feed relevant directories directly to the automated assistant.

Does Gemini CLI support background task execution for code analysis?

Yes, Gemini CLI supports background task execution for code analysis by utilizing its headless delegation capability, streamlining repetitive knowledge-work by offloading tasks without requiring manual input.

What is the best way to generate concise API docs for a project automatically?

The best way to generate concise API docs automatically is using headless delegation to execute a prompt like 'Create a concise API documentation for this project', which produces output directly without interactive sessions.