opencode-skills-collection 3.0.37 → 3.0.39

package/bundled-skills/2slides-ppt-generator/references/mcp-integration.md

@@ -0,0 +1,282 @@
+# MCP Integration Guide
+
+2slides provides an MCP (Model Context Protocol) server for seamless integration with Claude Desktop and other MCP-compatible AI agents.
+
+## What is the MCP Server?
+
+The 2slides MCP server exposes the same API functionality as direct API calls, but through a standardized tool interface that Claude can use directly without requiring script execution.
+
+**Available Tools:**
+1. `slides_generate` - Generate slides from content
+2. `slides_create_like_this` - Generate slides from reference image
+3. `slides_create_pdf_slides` - Generate custom-designed slides (NEW)
+4. `slides_generate_narration` - Add AI voice narration (NEW)
+5. `slides_download_pages_voices` - Export slides and voices as ZIP (NEW)
+6. `themes_search` - Search available themes
+7. `jobs_get` - Check job status
+
+**Note:** New tools (3-5) may require MCP server update to latest version.
+
+## Installation & Configuration
+
+2slides MCP server supports two integration modes:
+
+### Mode 1: Streamable HTTP Protocol (Recommended)
+
+Simplest setup using HTTP endpoint. No local installation required.
+
+**Step 1:** Get your API key from https://2slides.com/api
+
+**Step 2:** Configure Claude Desktop
+
+Edit: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
+
+```json
+{
+  "mcpServers": {
+    "2slides": {
+      "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
+    }
+  }
+}
+```
+
+**Step 3:** Restart Claude Desktop completely
+
+**Advantages:**
+- ✅ No Node.js or npm required
+- ✅ Always uses latest version
+- ✅ Faster setup
+- ✅ No local dependencies
+
+---
+
+### Mode 2: NPM Package (stdio)
+
+Uses local npm package for MCP server.
+
+**Step 1:** Get your API key from https://2slides.com/api
+
+**Step 2:** Configure Claude Desktop
+
+Edit: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
+
+```json
+{
+  "mcpServers": {
+    "2slides": {
+      "command": "npx",
+      "args": ["2slides-mcp"],
+      "env": {
+        "API_KEY": "YOUR_2SLIDES_API_KEY"
+      }
+    }
+  }
+}
+```
+
+**Step 3:** Restart Claude Desktop completely
+
+**Requirements:**
+- Node.js and npm installed
+- Internet connection for first-time package download
+
+---
+
+### Verify Installation
+
+After restart, the 2slides tools should be available. Test by asking:
+"Search for business themes using 2slides"
+
+## When to Use MCP vs Direct API
+
+### Use MCP Server When:
+- Working in Claude Desktop or other MCP-compatible environments
+- Want seamless tool integration without script management
+- Prefer Claude to handle API calls directly
+- Need real-time interaction and feedback
+
+### Use Direct API Scripts When:
+- Working in Claude Code CLI
+- MCP server is not configured or available
+- Need more control over parameters and error handling
+- Integrating into custom workflows or automation
+- Need to batch process multiple requests
+
+## MCP Tool Details
+
+### slides_generate
+
+Generate slides from user content.
+
+**Parameters:**
+- `userInput` (string, required): Content to convert
+- `themeId` (string, required): Theme ID from themes_search
+- `responseLanguage` (string, optional, default: "Auto"): Language name
+- `mode` (string, optional, default: "sync"): "sync" or "async"
+
+**Example:**
+```
+First search for a theme:
+Use themes_search with:
+- query: "business"
+
+Then generate with the theme ID:
+Use slides_generate with:
+- userInput: "Introduction to Python: Variables, Functions, Classes"
+- themeId: "theme_abc123"
+- mode: "sync"
+```
+
+### slides_create_like_this
+
+Generate slides matching a reference image.
+
+**Parameters:**
+- `userInput` (string, required): Content for slides
+- `referenceImageUrl` (string, required): URL or base64 of reference image
+- `responseLanguage` (string, optional, default: "Auto"): Language name
+- `aspectRatio` (string, optional, default: "16:9"): width:height format
+- `resolution` (string, optional, default: "2K"): "1K", "2K", or "4K"
+- `page` (number, optional, default: 1): Number of slides (0 for auto-detection, max 100)
+- `contentDetail` (string, optional, default: "concise"): "concise" or "standard"
+
+**Example:**
+```
+Use slides_create_like_this with:
+- userInput: "Sales Report Q4 2025"
+- referenceImageUrl: "https://example.com/template.jpg"
+- resolution: "2K"
+- page: 0  # Auto-detect slide count
+- contentDetail: "standard"
+```
+
+### themes_search
+
+Search for available themes.
+
+**Parameters:**
+- `query` (string, required): Search keyword
+- `limit` (number, optional, default: 20, max: 100): Max results
+
+**Example:**
+```
+Use themes_search with:
+- query: "business"
+- limit: 10
+```
+
+**Note:** Query parameter is required. Search with keywords like "business", "professional", "creative", "education", "modern" to find appropriate themes.
+
+### slides_create_pdf_slides
+
+Generate custom-designed slides from text without a reference image.
+
+**Parameters:**
+- `userInput` (string, required): Content for slides
+- `responseLanguage` (string, optional, default: "Auto"): Language name
+- `aspectRatio` (string, optional, default: "16:9"): width:height format
+- `resolution` (string, optional, default: "2K"): "1K", "2K", or "4K"
+- `page` (number, optional, default: 1): Number of slides (0 for auto-detection, max 100)
+- `contentDetail` (string, optional, default: "concise"): "concise" or "standard"
+- `designSpec` (string, optional): Design specifications
+
+**Example:**
+```
+Use slides_create_pdf_slides with:
+- userInput: "Sales Report Q4 2025"
+- designSpec: "modern minimalist, blue color scheme"
+- resolution: "2K"
+- page: 0  # Auto-detect slide count
+```
+
+### slides_generate_narration
+
+Add AI voice narration to completed slides.
+
+**Parameters:**
+- `jobId` (string, required): Job ID from slide generation (UUID format)
+- `language` (string, optional, default: "Auto"): Language for narration
+- `voice` (string, optional, default: "Puck"): Voice name (30 options available)
+- `multiSpeaker` (boolean, optional, default: false): Enable multi-speaker mode
+
+**Available Voices:**
+Puck, Aoede, Charon, Kore, Fenrir, Phoebe, Asteria, Luna, Stella, Theia, Helios, Atlas, Clio, Melpomene, Calliope, Erato, Euterpe, Polyhymnia, Terpsichore, Thalia, Urania, Zeus, Hera, Poseidon, Athena, Apollo, Artemis, Ares, Aphrodite, Hephaestus
+
+**Example:**
+```
+Use slides_generate_narration with:
+- jobId: "abc-123-def-456"
+- voice: "Aoede"
+- multiSpeaker: true
+- language: "English"
+```
+
+**Note:** Job must be completed before adding narration. Cost: 210 credits per page.
+
+### slides_download_pages_voices
+
+Download slides as PNG images and voice files as WAV in a ZIP archive.
+
+**Parameters:**
+- `jobId` (string, required): Job ID from slide generation
+
+**Example:**
+```
+Use slides_download_pages_voices with:
+- jobId: "abc-123-def-456"
+```
+
+**Note:** Completely FREE (no credits). Download URL valid for 1 hour.
+
+### jobs_get
+
+Check status of async job.
+
+**Parameters:**
+- `jobId` (string, required): Job ID from async generation
+
+**Response includes:**
+- Slide generation status
+- Narration status (if applicable)
+- Download URLs (when completed)
+
+**Example:**
+```
+Use jobs_get with:
+- jobId: "abc123..."
+```
+
+## Troubleshooting
+
+### Tools Not Appearing
+
+1. Verify configuration file syntax is valid JSON
+2. For HTTP mode: Check API key is correctly in the URL
+3. For npm mode: Ensure API key is correctly set in the `env` section
+4. Restart Claude Desktop completely (quit fully, not just close window)
+5. Check for error messages in Claude Desktop console
+
+### API Key Issues
+
+- Verify API key is active at https://2slides.com/api
+- Check for typos in the configuration
+- Ensure no extra quotes or spaces around the key
+- For HTTP mode: API key must be in the URL query parameter
+
+### HTTP Mode Issues
+
+- Verify URL format: `https://2slides.com/api/mcp?apikey=YOUR_KEY`
+- Check internet connectivity
+- Ensure API key has no special characters that need URL encoding
+
+### NPM Mode Issues
+
+- Ensure `npx` is available (requires Node.js)
+- Try running `npx 2slides-mcp` manually to check for errors
+- Verify internet connection for package download
+- Check Node.js version compatibility
+
+## GitHub Repository
+
+For more information, visit: https://github.com/2slides/mcp-2slides

package/bundled-skills/2slides-ppt-generator/references/pricing.md

@@ -0,0 +1,195 @@
+# 2slides Pricing & Credit Information
+
+Complete pricing details and credit system information.
+
+## Credit System Overview
+
+2slides operates on a **pay-as-you-go credit system** with no monthly subscriptions or recurring charges.
+
+### Key Benefits
+
+- ✅ **Credits never expire** - Use them at your own pace
+- ✅ **No subscriptions** - Pay only for what you use
+- ✅ **Volume discounts** - Save up to 20% on larger packages
+- ✅ **3-day refund window** - Risk-free purchase
+- ✅ **500 free credits** - Free trial for new users
+
+## Credit Packages
+
+**Current Promotion:** Up to 20% off credits for a limited time.
+
+| Credits | Original Price | Current Price | Discount | Cost per 1,000 |
+|---------|----------------|---------------|----------|----------------|
+| 2,000 | $5.00 | $5.00 | — | $2.50 |
+| 4,000 | $10.00 | $9.50 | 5% | $2.38 |
+| 10,000 | $25.00 | $22.50 | 10% | $2.25 |
+| 20,000 | $50.00 | $42.50 | 15% | $2.13 |
+| 40,000 | $100.00 | $80.00 | 20% | $2.00 |
+
+**Purchase at:** https://2slides.com/pricing
+
+## Credit Costs by Feature
+
+| Feature | Credits per Page | Example (10 pages) |
+|---------|-----------------|-------------------|
+| Fast PPT (theme-based) | 10 | 100 credits |
+| Nano Banana 1K/2K (image/custom) | 100 | 1,000 credits |
+| Nano Banana 4K | 200 | 2,000 credits |
+| Voice Narration | +210 | +2,100 credits |
+| Download Export | FREE | 0 credits |
+
+### Detailed Cost Breakdown
+
+**Fast PPT Generation (Theme-Based)**
+- 10 credits per page
+- Uses pre-designed themes
+- Fastest generation mode
+- Cost example: 20-page presentation = 200 credits
+
+**Nano Banana (Image Matching / Custom PDF)**
+- **1K/2K resolution:** 100 credits per page
+- **4K resolution:** 200 credits per page
+- Matches reference image style or generates custom design
+- Higher quality output
+- Cost example: 10-page 2K presentation = 1,000 credits
+
+**Voice Narration**
+- 210 credits per page total
+  - 10 credits for text processing
+  - 200 credits for audio generation
+- 30 voice options available
+- Multi-speaker mode included
+- Cost example: 5-page narration = 1,050 credits
+
+**Download Export**
+- Completely FREE (0 credits)
+- Export slides as PNG images
+- Export voice files as WAV
+- Includes transcripts
+
+## Free Trial
+
+**New users receive 500 free credits** upon account creation.
+
+**What you can do with 500 credits:**
+- Create ~50 Fast PPT slide pages
+- Create ~5 Nano Banana 2K pages
+- Create ~2 Nano Banana 2K pages with full narration
+- Mix and match features as needed
+
+## Example Cost Calculations
+
+### Scenario 1: Quick Business Presentation
+- **Need:** 15-slide Fast PPT presentation
+- **Credits required:** 150 credits (15 pages × 10 credits)
+- **Cost with 2,000 package:** $0.38
+- **Cost with 40,000 package:** $0.30
+
+### Scenario 2: Branded Marketing Deck
+- **Need:** 20-slide Nano Banana 2K matching brand image
+- **Credits required:** 2,000 credits (20 pages × 100 credits)
+- **Cost with 4,000 package:** $4.75
+- **Cost with 40,000 package:** $4.00
+
+### Scenario 3: Training Presentation with Audio
+- **Need:** 30-slide 2K presentation with voice narration
+- **Credits required:** 6,300 credits
+  - Slides: 3,000 credits (30 pages × 100 credits)
+  - Narration: 3,300 credits (30 pages × 110 credits - voice only)
+- **Cost with 10,000 package:** $14.18
+- **Cost with 40,000 package:** $12.60
+
+### Scenario 4: High-Resolution Portfolio
+- **Need:** 10-slide 4K Nano Banana presentation
+- **Credits required:** 2,000 credits (10 pages × 200 credits)
+- **Cost with 4,000 package:** $4.75
+- **Cost with 40,000 package:** $4.00
+
+### Scenario 5: Complete Package
+- **Need:** 25-slide 2K presentation with narration, exported as PNG/WAV
+- **Credits required:** 5,250 credits
+  - Slides: 2,500 credits (25 pages × 100 credits)
+  - Narration: 2,750 credits (25 pages × 110 credits - voice only)
+  - Export: 0 credits (FREE)
+- **Cost with 10,000 package:** $11.81
+- **Cost with 40,000 package:** $10.50
+
+## Payment Methods
+
+Accepted payment methods via Stripe:
+- Major credit cards (Visa, Mastercard, American Express, Discover)
+- Apple Pay
+- Google Pay
+
+## Refund Policy
+
+- **3-day refund window** after purchase
+- Contact support through https://2slides.com for refund requests
+- Credits must not have been substantially used
+
+## Enterprise & Team Plans
+
+Currently in development. For high-volume or team needs, contact 2slides support through https://2slides.com.
+
+## Checking Your Credit Balance
+
+**Via Web:**
+1. Visit https://2slides.com/api
+2. Log in to your account
+3. View your dashboard for current credit balance and usage history
+
+**Via API:**
+- Credit balance is returned in API error responses when insufficient
+- Check account page for detailed usage tracking
+
+## Credit Expiration
+
+**Credits NEVER expire.** Purchase credits and use them at your own pace without time pressure.
+
+## Best Practices for Credit Management
+
+1. **Start with free credits** - Use your 500 free credits to test features
+2. **Calculate needs** - Estimate your typical usage before purchasing
+3. **Buy in bulk** - Larger packages offer better value (up to 20% off)
+4. **Monitor usage** - Check your dashboard regularly to track consumption
+5. **Plan ahead** - Buy credits before you need them to take advantage of promotions
+
+## Rate Limits
+
+Credit purchases do not affect API rate limits:
+- Fast PPT: 10 requests per minute
+- Nano Banana: 6 requests per minute
+
+Rate limits are based on API tier, not credit balance.
+
+## Common Questions
+
+**Q: Do credits expire?**
+A: No, credits never expire.
+
+**Q: Can I get a refund?**
+A: Yes, within 3 days of purchase if credits haven't been substantially used.
+
+**Q: What happens if I run out of credits?**
+A: API requests will return an INSUFFICIENT_CREDITS error. Purchase more credits to continue.
+
+**Q: Can I share credits with my team?**
+A: Currently, credits are tied to individual API keys. Team plans are in development.
+
+**Q: Are there discounts for students or nonprofits?**
+A: Contact 2slides support for special pricing inquiries.
+
+**Q: How do I know how many credits I have left?**
+A: Check your dashboard at https://2slides.com/api
+
+## Resources
+
+- **Purchase Credits:** https://2slides.com/pricing
+- **API Dashboard:** https://2slides.com/api
+- **Main Website:** https://2slides.com
+- **API Documentation:** See api-reference.md
+- **Skill Guide:** See SKILL.md
+
+---
+
+*Pricing information last updated: 2026-02-10*

package/bundled-skills/2slides-ppt-generator/scripts/api_constants.py

@@ -0,0 +1,87 @@
+#!/usr/bin/env python3
+"""
+2slides API allowed parameter values. Aligned with https://2slides.com/api.md
+"""
+
+API_BASE_URL = "https://2slides.com/api/v1"
+
+# responseLanguage (all endpoints that accept it)
+RESPONSE_LANGUAGES = [
+    "Auto",
+    "English",
+    "Spanish",
+    "Arabic",
+    "Portuguese",
+    "Indonesian",
+    "Japanese",
+    "Russian",
+    "Hindi",
+    "French",
+    "German",
+    "Greek",
+    "Vietnamese",
+    "Turkish",
+    "Polish",
+    "Italian",
+    "Korean",
+    "Simplified Chinese",
+    "Traditional Chinese",
+    "Thai",
+]
+
+# aspectRatio (create-like-this, create-pdf-slides)
+ASPECT_RATIOS = [
+    "1:1",
+    "2:3",
+    "3:2",
+    "3:4",
+    "4:3",
+    "4:5",
+    "5:4",
+    "9:16",
+    "16:9",
+    "21:9",
+]
+
+# resolution (create-like-this, create-pdf-slides)
+RESOLUTIONS = ["1K", "2K", "4K"]
+
+# contentDetail / contentMode
+CONTENT_DETAILS = ["concise", "standard"]
+
+# mode (generate, create-like-this, create-pdf-slides)
+MODES = ["sync", "async"]
+
+# generate-narration: Supported Voices (30 total, from API doc)
+NARRATION_VOICES = [
+    "Puck",
+    "Aoede",
+    "Charon",
+    "Kore",
+    "Fenrir",
+    "Zephyr",
+    "Leda",
+    "Orus",
+    "Callirrhoe",
+    "Autonoe",
+    "Enceladus",
+    "Iapetus",
+    "Umbriel",
+    "Algieba",
+    "Despina",
+    "Erinome",
+    "Algenib",
+    "Rasalgethi",
+    "Laomedeia",
+    "Achernar",
+    "Alnilam",
+    "Schedar",
+    "Gacrux",
+    "Pulcherrima",
+    "Achird",
+    "Zubenelgenubi",
+    "Vindemiatrix",
+    "Sadachbia",
+    "Sadaltager",
+    "Sulafat",
+]