Superconductor Gemini Skills CLI

A command-line interface (CLI) for interacting with Google Gemini AI models, including for video understanding, audio understanding, image generation, video generation.

Developed by the superconductor.dev team. We help you build software with AI agents.

Used by plugins in the Superconductor Plugin Marketplace

Usage

# Simple question
npx superconductor-gemini-skills "Tell me a joke"

# Video understanding (local file)
npx superconductor-gemini-skills --file=video.mp4 "Summarize this video"

# Video understanding (YouTube)
npx superconductor-gemini-skills --file="https://www.youtube.com/watch?v=dQw4w9WgXcQ" "What happens in this video?"

# Audio transcription
npx superconductor-gemini-skills --file=recording.mp3 "Transcribe this audio"

# PDF analysis
npx superconductor-gemini-skills --file=document.pdf "Summarize the key findings"

# Image analysis
npx superconductor-gemini-skills --file=diagram.png "Explain what this diagram shows"

# Image generation
npx superconductor-gemini-skills --model=gemini-3-pro-image-preview "A sunset over mountains"

# Video generation
npx superconductor-gemini-skills --model=veo-3.1-generate-preview "A cat playing with yarn"

# Text-to-speech
npx superconductor-gemini-skills --model=gemini-2.5-flash-preview-tts "Hello, welcome!"

Development

Running Tests

# Run tests using fixtures
npm run test

# Run tests without fixtures (make sure to set your GEMINI_API_KEY env variable)
rm test/fixtures/*.json && npm run test