skill-porter

Convert Claude Code skills to Gemini CLI extensions and vice versa.

189|18|Updated Nov 11, 2025
One-click install
npx skills add https://github.com/jduncan-rva/skill-porter --skill skill-porter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-porter
Source: https://github.com/jduncan-rva/skill-porter/tree/main/.
Command: npx skills add https://github.com/jduncan-rva/skill-porter --skill skill-porter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires js-yaml, commander, chalk, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Developers often face the challenge of rewriting AI skills or extensions to be compatible with different platforms like Claude Code and Gemini CLI. This Skill eliminates that tedious, time-consuming duplication, allowing you to write once and deploy across multiple AI environments.

Core Features & Use Cases

  • Bidirectional Conversion: Effortlessly convert skills from Claude Code to Gemini CLI, and vice versa, preserving functionality and context.
  • Metadata Transformation: Automatically handles complex conversions like YAML frontmatter ↔ JSON manifests, allowed-toolsexcludeTools, and environment variables ↔ settings schemas.
  • Universal Compatibility: Create a single, unified skill that functions seamlessly on both Claude Code and Gemini CLI, maximizing reach and minimizing maintenance.
  • Use Case: A developer has built a powerful data analysis skill for Claude Code and wants to make it available to their team who primarily uses Gemini CLI. Instead of rewriting, they use Skill Porter to convert it in minutes, ensuring consistent functionality across platforms.

Quick Start

Convert my Claude skill at './my-project' to a Gemini extension.

Frequently Asked Questions about skill-porter

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

FAQPage Schema
How do I convert a Claude Code skill to a Gemini CLI extension?

Skill Porter converts Claude Code skills to Gemini CLI extensions by transforming YAML frontmatter into JSON manifests, inverting allowed-tools to excludeTools, and updating MCP paths. Point it to your skill directory and it handles metadata transformation and validation automatically.

Can I convert Gemini extensions back to Claude Code skills?

Yes, Skill Porter performs bidirectional conversion. It transforms Gemini gemini-extension.json and GEMINI.md files into Claude Code SKILL.md frontmatter and .claude-plugin/marketplace.json, preserving functionality and MCP configurations.

What metadata gets transformed between Claude and Gemini formats?

Skill Porter handles YAML ↔ JSON manifest conversion, allowed-tools ↔ excludeTools inversion, environment variable documentation ↔ settings schema inference, and extensionPath updates for MCP preservation across both platforms.

Does Skill Porter preserve MCP and tool configurations during conversion?

Yes, Skill Porter preserves MCP configurations by updating extensionPath references and maintains tool definitions through allowed-tools to excludeTools mapping, ensuring your extension works identically on both platforms.

What's the best way to maintain a skill across both Claude Code and Gemini CLI?

Use Skill Porter to convert once between formats, eliminating manual duplication. This approach preserves functionality consistency and reduces maintenance overhead when updating features or documentation for dual-platform deployment.

Can I validate the converted skill output before deployment?

Skill Porter includes validation of output to ensure converted manifests and metadata are correctly formatted and complete, catching transformation errors before you deploy to either Claude Code or Gemini CLI environments.