Initial commit

skills/gemini-imagegen/README.md

@@ -0,0 +1,103 @@
+# Gemini ImageGen Skill
+
+AI-powered image generation, editing, and composition using Google's Gemini API.
+
+## Quick Start
+
+1. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+2. **Set your API key:**
+   ```bash
+   export GEMINI_API_KEY="your-api-key-here"
+   ```
+   Get your key from: https://makersuite.google.com/app/apikey
+
+3. **Generate an image:**
+   ```bash
+   npm run generate "a sunset over mountains" output.png
+   ```
+
+## Features
+
+- **Generate**: Create images from text descriptions
+- **Edit**: Modify existing images with natural language prompts
+- **Compose**: Combine multiple images with flexible layouts
+
+## Usage Examples
+
+### Generate Images
+```bash
+# Basic generation
+npm run generate "futuristic city skyline" city.png
+
+# Custom size
+npm run generate "modern office" office.png -- --width 1920 --height 1080
+```
+
+### Edit Images
+```bash
+# Style transformation
+npm run edit photo.jpg "make it look like a watercolor painting" artistic.png
+
+# Object modification
+npm run edit landscape.png "add a rainbow in the sky" enhanced.png
+```
+
+### Compose Images
+```bash
+# Grid layout (default)
+npm run compose collage.png img1.jpg img2.jpg img3.jpg img4.jpg
+
+# Horizontal banner
+npm run compose banner.png left.png right.png -- --layout horizontal
+
+# Custom composition
+npm run compose result.png a.jpg b.jpg -- --prompt "blend seamlessly"
+```
+
+## Scripts
+
+- `npm run generate <prompt> <output>` - Generate image from text
+- `npm run edit <source> <prompt> <output>` - Edit existing image
+- `npm run compose <output> <images...>` - Compose multiple images
+
+## Configuration
+
+### Environment Variables
+
+- `GEMINI_API_KEY` (required) - Your Google Gemini API key
+
+### Options
+
+See `SKILL.md` for detailed documentation on all available options and parameters.
+
+## Development Notes
+
+This is a local development skill that runs on your machine, not on Cloudflare Workers. It's designed for:
+
+- Design workflows and asset creation
+- Visual content generation
+- Image manipulation and prototyping
+- Creating test images for development
+
+## Implementation Status
+
+**Note**: The current implementation includes:
+- Complete TypeScript structure
+- Argument parsing and validation
+- Gemini API integration for image analysis
+- Comprehensive error handling
+
+For production use with actual image generation/editing, you'll need to:
+1. Use the Imagen model (imagen-3.0-generate-001)
+2. Implement proper image data handling
+3. Add output file writing with actual image data
+
+Refer to the [Gemini Imagen documentation](https://ai.google.dev/docs/imagen) for implementation details.
+
+## License
+
+MIT