Sandbox
Sign in
@saeed-vayghan/gemini-agent-skills
Skills#Gemini CLI#Claude Code#Coding#Docs

Gemini skills collection and Claude converter CLI

This repository packages a large set of Gemini Agent Skills and includes a CLI that converts Claude Code agents, plugins, and skills into Gemini-ready skills. The converter uses Gemini API parsing to reshape existing agent definitions into the format Gemini expects, while the `.gemini/skills` folder provides ready-to-use examples.

34 stars•8 forks•TypeScript•Updated 8mo ago
Who it's for

Builders who use Gemini CLI or Claude Code and want reusable agent skills they can copy or convert.

What it delivers

You can reuse existing agent setups in Gemini instead of rebuilding them by hand.

What it does

Gemini skill collection

Provides a large catalog of ready-made skills such as database, frontend, code review, and security helpers.

Claude to Gemini converter

Converts Claude plugins, agents, and skills into Gemini Agent Skills with a CLI command.

Plugin mode

Merges a directory of multiple agents and nested skills into one unified Gemini skill output.

Agents mode

Converts a folder of loose agent markdown files into separate Gemini skills.

Asset extraction

Pulls code blocks and supporting material out of prompts into skill assets.

Link repair

Detects and fixes broken internal markdown links during conversion.

Registry generation

Builds structured `SKILL.md` files with persona and workflow registries.

How to get it

  1. 1Best for converting full Claude Plugins that contain multiple agents and tools working…
    # 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
  2. 2Output Structure: A single folder in output dir
    my-gemini-skills/
  └── MyPluginName/
      ├── SKILL.md (Unified instructions)
      ├── references/
      │   └── workflows/ (Flattened skills)
      └── assets/
      └── scripts/
  3. 3Best for converting a folder of loose, independent agent files (e.g., expert-coder.md,…
    # Use the --agents flag
node dist/index.js convert --input ../my-agents-folder --agents
  4. 4Output Structure: Multiple folders in output dir
    my-gemini-skills/
  ├── expert-coder/
  │   └── SKILL.md
  │   ├── ...
  └── writer/
      └── SKILL.md
      ├── ...

README

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

Files in the repo

Repository payload•6 top-level entries
  • .agent
  • .gemini
  • cli
  • .gitignore
  • LICENSE
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers
obra/superpowersSkills

An agentic skills framework & software development methodology that works.

285k
1 add
Graphify-Labs/graphifySkills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer
Vincentwei1021/anything2explainerSkills

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666
career-ops-hq/career-opsSkills

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k