Skip to content
BranchesTags

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
.agent
.agent
 
 
.gemini
.gemini
 
 
cli
cli
 
 
.gitignore
.gitignore
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 

Repository files navigation

Gemini Agent Skill

A comprehensive collection of expert AI Agent Skills for Google Gemini.

Claude to Gemini Converter CLI

A CLI tool to convert Anthropic Claude "Code" configurations (Plugins, Agents, Skills) into Google Gemini Agent Skills.

This tool uses gemini-2.0-flash-exp (via the API) to intelligently parse, refine, and restructure your existing agent definitions into the format required by the Gemini Agent Playground.

Why this Tool?

Claude Code has offered powerful agents and plugins for a while, but until now, there was no easy way to access these capabilities within the Gemini ecosystem. This repository solves that problem by converting existing configurations so you can use them with Gemini immediately.

This is made possible by the new Gemini Agent Skill feature, which empowers Gemini to handle complex tasks just like other advanced AI coding tools. You can read the official documentation here.

Credits

This project builds upon the amazing work done by the VoltAgent team. They created the original collection of Claude Code subagents, and we want to give them full credit for these definitions. My goal is to take these proven agent patterns and optimize them for even greater efficiency on Gemini.

What's Next?

I am dedicated to optimizing these agents to be fully native and highly efficient within the Gemini ecosystem.

Currently, I am developing an advanced configuration system that utilizes Project Mitra. This will unlock deeper customization and more structured control over your Gemini Agent Skills.

Using Gemini Agent Skills

Once you have generated your skills, you can interact with them directly in the Gemini CLI.

How to use:

# Install Gemini@0.24.0-preview.0
npm install -g @google/gemini-cli@0.24.0-preview.0

# Confirm version
gemini --version               
> 0.24.0-preview.0

# Clone repository
git clone https://github.com/saeed-vayghan/gemini-agent-skills.git

# Copy any skill to your .gemini/skills directory
cp .gemini/skills/<any-skill> /path/to/your/.gemini/skills/


# Run Gemini CLI
gemini

> /skills list

- api-auditor
    Expertise in auditing and testing API endpoints. Use when the user asks to "check", "test", or "audit" a URL or API.

- database-optimizer
    Expert database optimizer specializing in query optimization and performance tuning.

Example Interaction: Simply ask for help, and Gemini will automatically activate the relevant expert skill.

> how can you help me to optimize my Mongodb collection?

✦ I can help you with that. I'll activate the database-optimizer skill to provide you with expert guidance on optimizing your MongoDB
  collection.
╭────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ ✓  Activate Skill "database-optimizer": Expert database optimizer specializing in query optimization, performance tuning, and scalability… │
│                                                                                                                                            │
│ Skill **database-optimizer** activated. Resources loaded:                                                                                  │
│                                                                                                                                            │
│ ├───SKILL.md                                                                                                                               │
│ ├───assets/                                                                                                                                │
│ │   ├───optimization_context_query.json                                                                                                    │
│ │   └───progress_tracking.json                                                                                                             │
│ └───references/                                                                                                                            │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
✦ To assist you with optimizing your MongoDB collection, I can help with query analysis, index strategy, schema design, and configuration
  tuning.

  To get started, please share some details about your situation:

   1. What is the primary issue? (e.g., slow specific queries, high CPU usage, slow writes, general sluggishness)
   2. Collection Statistics: Roughly how many documents are in the collection and what is the total data size?
   3. Query Patterns: Can you share an example of a slow query and its typical filter/sort criteria?
   4. Current Indexes: What indexes do you currently have defined on this collection?
   5. Document Structure: A brief description or JSON example of a typical document.

  Once you provide this context, I can analyze the situation and recommend specific optimizations.

Features

  • Dual Conversion Modes:
    • Plugin Mode (Default): Merges a complex directory of multiple agents and nested skills into a Single Unified Gemini Skill.
    • Agents Mode: Batch converts a directory of individual agent markdown files into separate, independent Gemini Skills.
  • AI-Powered Analysis: Automatically understands directory structures and categorizes files as Personas (Agents) or Workflows (Skills).
  • Smart Asset Extraction: Extracts code blocks from agent prompts into file assets.
  • Link Fidelity: Automatically detects and fixes broken internal links in your markdown files.
  • Registry System: Generates structured SKILL.md files with Persona and Workflow registries.

Agile & Custom Usage

You do NOT need to install every agent!

The beauty of this system is its modularity. You should treat this repository as a menu of capabilities:

  1. Browse the Categories: Look through the list below and find the specific expert you need (e.g., just the sql-pro and backend-developer).
  2. Pick & Choose: Clone or convert only the specific agents relevant to your current project.
  3. Bring Your Own: If you have your own custom Claude prompts or agents, use the CLI tool to instantly convert them into Gemini-ready skills.

Build your own perfect team of AI experts, tailored exactly to your workflow.

Installation

# Clone repository
git clone https://github.com/saeed-vayghan/gemini-agent-skills.git
cd cli

# Install dependencies
npm install

# Build
npm run build

Configuration

Create a .env file in the cli directory with your Google Gemini API key:

GEMINI_API_KEY=your_api_key_here

Usage

1. Plugin Mode (Default)

Best for converting full Claude Plugins that contain multiple agents and tools working together.

# Convert a directory
node dist/index.js convert --input ../path/to/claude-plugin --output ../my-gemini-skills

# Force overwrite if output exists
node dist/index.js convert --input ../claude-plugin --force

Output Structure: A single folder in output dir:

my-gemini-skills/
  └── MyPluginName/
      ├── SKILL.md (Unified instructions)
      ├── references/
      │   └── workflows/ (Flattened skills)
      └── assets/
      └── scripts/

2. Agents Mode

Best for converting a folder of loose, independent agent files (e.g., expert-coder.md, writer.md).

# Use the --agents flag
node dist/index.js convert --input ../my-agents-folder --agents

Output Structure: Multiple folders in output dir:

my-gemini-skills/
  ├── expert-coder/
  │   └── SKILL.md
  │   ├── ...
  └── writer/
      └── SKILL.md
      ├── ...

List of Agent Skills

01. Core Development

Essential development subagents for everyday coding tasks.

02. Language Specialists

Language-specific experts with deep framework knowledge.

03. Infrastructure

DevOps, cloud, and deployment specialists.

04. Quality & Security

Testing, security, and code quality experts.

05. Data & AI

Data engineering, ML, and AI specialists.

06. Developer Experience

Tooling and developer productivity experts.

07. Specialized Domains

Domain-specific technology experts.

08. Business & Product

Product management and business analysis.

09. Meta & Orchestration

Agent coordination and meta-programming.

10. Research & Analysis

Research, search, and analysis specialists.

11. Google AI Specialists

About

A comprehensive collection of expert AI Agent Skills for Google Gemini, featuring a powerful CLI to convert and optimize Claude Code agents for the Gemini ecosystem.

Topics

agent-skillsagentsaiantigravitygemini

Resources

Readme
MIT license
Activity

Stars

32 stars

Watchers

0 watching

Forks

7 forks
Report repository

Releases

Packages

Contributors

Languages