ImaginePro Claude Code Plugin
Professional AI image and video generation without leaving Claude Code. Generate web assets, UI components, marketing materials, and videos with specialized agents and intelligent workflows.
🎯 What Makes This Plugin Special
Unlike directly using the ImaginePro MCP server, this plugin provides:
- 🤖 4 Specialized Agents - Domain experts for web dev, UI/UX, marketing, and video
- ⚡ Smart Commands - Workflow automation beyond basic MCP tool calls
- 📚 Educational - Learn prompt engineering and best practices
- 🎨 Production-Ready - Platform-specific optimization and quality guidance
- 🚀 Workflow Focus - Complete pipelines, not just individual tools
✨ Features
Specialized Agents
- 🌐 Web Asset Producer - Hero images, backgrounds, web-optimized assets
- 🎨 UI/UX Asset Generator - Icons, illustrations, design system components
- 📱 Marketing Creative Specialist - Ads, social media, campaign materials
- 🎬 Video Workflow Director - Motion content and video animations
Smart Commands
/imagine-pro - Intelligent generation with prompt guidance/upscale-it - Quick production-quality enhancement/vary-it - Smart variations and refinements/video-flow - Complete video workflow automation/imagine-guide - Interactive learning and best practices
Underlying Power
Access to 8 ImaginePro MCP tools:
- Text-to-image generation
- Multi-modal generation (Gemini)
- Video generation
- Image upscaling
- Variants and rerolls
- Inpainting
- Status tracking
🚀 Quick Start
Prerequisites
Note: The MCP server (imaginepro-mcp-server) is automatically installed via npx when the plugin loads - no manual installation needed!
Installation
Option 1: From ImaginePro Marketplace (Recommended)
# Add the ImaginePro marketplace
/plugin marketplace add imaginpro/claude-marketplace
# Install the plugin
/plugin install imaginepro
# Set your API key
export IMAGINEPRO_API_KEY="sk-your-api-key-here"
Option 2: From GitHub
# Add the plugin repository (full URL format)
/plugin marketplace add https://github.com/imaginpro/imaginepro-claude-plugin
# Install
/plugin install imaginepro
# Verify installation
/plugin list
# Set your API key
export IMAGINEPRO_API_KEY="sk-your-api-key-here"
Option 3: Local Development
# Clone the repository
git clone https://github.com/imaginpro/imaginepro-claude-plugin.git
cd imaginepro-claude-plugin
# Add local plugin using absolute path
/plugin marketplace add /path/to/imaginepro-claude-plugin
# Or use relative path if in the plugin directory
/plugin marketplace add ./
# Install
/plugin install imaginepro
# Set your API key
export IMAGINEPRO_API_KEY="sk-your-api-key-here"
Get Your API Key
- Sign up at imaginepro.ai
- Navigate to account settings
- Generate an API key (starts with
sk-)
- Set it as an environment variable
For current session:
export IMAGINEPRO_API_KEY="sk-your-api-key-here"
Make it permanent (choose your shell):
For Zsh (macOS default):
echo 'export IMAGINEPRO_API_KEY="sk-your-api-key-here"' >> ~/.zshrc
source ~/.zshrc
For Bash:
echo 'export IMAGINEPRO_API_KEY="sk-your-api-key-here"' >> ~/.bash_profile
source ~/.bash_profile
Verify it's set:
echo $IMAGINEPRO_API_KEY
📖 Usage Examples
Web Development
# Activate Web Asset Producer agent
"I need a hero image for my SaaS landing page"
# Or use the command directly
/imagine-pro modern SaaS hero image, professional team collaborating,
blue color scheme, space for headline in upper third, 1920x1080
# Upscale for production
/upscale-it [messageId]
UI/UX Design
# Activate UI/UX Asset Generator
"Create 5 navigation icons for my mobile app"
# Agent guides you through creating a consistent set
# Or generate individually
/imagine-pro minimal line icon for home navigation, clean geometric,
64px, monochrome, 3px stroke weight
Marketing
# Activate Marketing Creative Specialist
"Create 3 Instagram ad variants for my product launch"
# Agent creates A/B test-ready variants
# Or use command
/imagine-pro Instagram ad creative, 1:1 format, productivity app,
scroll-stopping visual, mobile-optimized
Video Production
# Use the automated workflow
/video-flow product reveal: wireless headphones from box to wearing,
studio photography style
# Or work with Video Director agent for more control
"Create a day-to-night city timelapse video"
🎓 Learning Resources
Interactive Guide
/imagine-guide
# Or ask specific questions:
/imagine-guide how do I create a hero image?
/imagine-guide best practices for icon sets
/imagine-guide tips for smooth video transitions
Documentation
📂 Repository Structure
imaginepro-claude-plugin/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── .mcp.json # MCP server configuration
├── agents/ # 4 specialized agents
│ ├── web-asset-producer.md
│ ├── ui-asset-generator.md
│ ├── marketing-creative.md
│ └── video-director.md
├── commands/ # 5 smart commands
│ ├── imagine-pro.md
│ ├── upscale-it.md
│ ├── vary-it.md
│ ├── video-flow.md
│ └── imagine-guide.md
├── docs/ # Documentation
│ ├── quick-start.md
│ ├── workflows/
│ ├── prompt-library/
│ └── troubleshooting.md
└── examples/ # Real-world examples
🎯 Common Workflows
Image Generation Workflow
1. Generate initial image
/imagine-pro [detailed prompt]
2. Explore variations
/vary-it [messageId]
3. Choose best version
4. Upscale for production
/upscale-it [best-messageId]
5. Download and use!
Video Creation Workflow
1. Describe transformation
/video-flow [clear transformation description]
2. Review generated video
(automatically creates frames and video)
3. Use in project!
A/B Testing Workflow
1. Generate initial creative
/imagine-pro [prompt]
2. Create test variants
/vary-it [messageId] # Variant A
/vary-it [messageId] # Variant B
/vary-it [messageId] # Variant C
3. Test all variants
4. Upscale winner
/upscale-it [winning-messageId]
💡 Why Use This Plugin?
vs. Direct MCP Server Usage
- ✅ Easier: Specialized agents make it accessible
- ✅ Smarter: Workflow automation and intelligent routing
- ✅ Educational: Learn best practices as you work
- ✅ Optimized: Domain-specific prompting expertise
vs. External Tools (Midjourney, DALL-E, etc.)
- ✅ Integrated: No context switching from Claude Code
- ✅ Conversational: Natural language, no special syntax
- ✅ Workflow-Aware: Understands your development context
- ✅ Automated: Multi-step processes in single commands
vs. Generic Image Generation
- ✅ Specialized: Purpose-built for development workflows
- ✅ Production-Ready: Knows specs, dimensions, use cases
- ✅ Complete: Video generation, not just images
- ✅ Professional: Business/development focus
🛠️ Configuration
Environment Variables
# Required
export IMAGINEPRO_API_KEY="sk-your-api-key"
# Optional
export IMAGINEPRO_BASE_URL="https://api.imaginepro.ai" # Custom endpoint
export IMAGINEPRO_TIMEOUT="300000" # Timeout in ms
Plugin Settings
The plugin automatically configures the ImaginePro MCP server. Configuration is in .mcp.json:
{
"mcpServers": {
"imaginepro": {
"command": "npx",
"args": ["-y", "imaginepro-mcp-server"],
"env": {
"IMAGINEPRO_API_KEY": "${IMAGINEPRO_API_KEY}"
}
}
}
}
🤝 Contributing
We welcome contributions! Whether it's:
- 🐛 Bug reports
- 💡 Feature requests
- 📝 Documentation improvements
- 🎨 Prompt library additions
- 🔧 Code contributions
See CONTRIBUTING.md for guidelines.
📄 License
MIT License - see LICENSE file for details.
🔗 Links
💬 Support
🙏 Acknowledgments
Built with:
Made with ❤️ for the Claude Code community
