gemini-extension-generator
An agent specialized in scaffolding robust Gemini CLI extensions, MCP servers, and custom commands.
Open source Open in the app JSON README (API)
About
An agent specialized in scaffolding robust Gemini CLI extensions, MCP servers, and custom commands.
Details
- Kind
- Plugins
- Topic
- AI, RAG & memory
- Publisher
- dull-bird
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.0
- Stars
- 2
- Last push
- 2026-03-23T12:44:09Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
dull-bird/gemini_extension_skill
README
# Gemini Extension Generator Plugin
[中文文档 (Chinese Version)](README_zh.md)
A powerful, hyper-modular Gemini CLI plugin designed to autonomously scaffold, configure, and generate complete Gemini CLI extensions, Model Context Protocol (MCP) servers, custom commands, hooks, and specialized agent skills.
## ✨ Highlights & Key Features
* **Hyper-Modular Component Architecture:**
Instead of a massive, brittle prompt, the core generation logic is broken down into highly specialized operational components (`manifest.md`, `commands.md`, `hooks.md`, etc.). These are dynamically injected into the parent agent skill using Gemini's native `@file.md` context compiling syntax. This ensures clean logic separation and completely eliminates hallucination.
* **Self-Updating Official Knowledge Base (`/sync`):**
The extension ships with an unblockable, zero-dependency Python background script. Utilizing `git clone`, it expertly bypasses restrictive GitHub API rate-limits and proxy SSL blocks. By simply running the `/sync` shortcut, the plugin flawlessly refreshes its own `docs/` database with the absolute latest official Gemini CLI documentation straight from the upstream source.
* **Integrated Anthropic "Skill Creator" Philosophies:**
The plugin directly ingests the official Claude `skill-creator` standard from Anthropic. Any Agent Skill generated by this extension inherently adopts world-class prompt-engineering principles such as **Pushy YAML Descriptions** (to combat model under-triggering), **Progressive Folder Disclosure** (to scale dynamically and save context tokens), and **Implicit Theory-of-Mind Styling**.
* **Dual-Command Macros:**
* `/extension:generate [requirements]`: Instantly spins up the agent to build your extension components flawlessly based strictly on the verified local docs schema.
* `/extension:sync`: Triggers the local documentation refresh pipeline natively entirely off the shell hook, piping status output straight back to the conversational interface.
## 🚀 Getting Started
1. **Install the Extension:**
Install the plugin directly into your Gemini CLI environment using the repository URL:
```bash
gemini extensions install https://github.com/dull-bird/gemini_extension_skill.git
```
*(If you have cloned the source code locally, you can alternatively run `gemini extensions install .` in the root folder).*
2. **Generate your first component:**
Open a new Gemini CLI session and use the built-in macro to construct complex plugins:
```bash
/extension:generate a new extension that summarizes git commit diffs using a custom hook
```
3. **Keep your Framework Updated:**
Whenever Gemini CLI releases a structural update upstream, simply run:
```bash
/extension:sync
```
The repository will quietly refresh its entire knowledge library to guarantee your components always utilize the latest CLI capabilities.