myaidev-method 0.2.24-1 → 0.2.24-2

package/skills/visual-generator/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: visual-generator
+description: Generate high-quality images and videos using AI APIs (Gemini, Imagen, DALL-E, FLUX, Veo)
+argument-hint: [prompt] [--type=hero] [--service=gemini]
+allowed-tools: [Read, Write, Bash, Task]
+user-invocable: true
+category: visual
+version: 1.0.0
+platforms: [claude-code, gemini-cli, codex-cli]
+---
+
+# Visual Generator Skill
+
+Generate high-quality images and videos for content creation using AI generation APIs (Google Gemini Flash, Imagen 3, DALL-E 3, FLUX 2 Pro, Veo 3).
+
+## Capabilities
+
+- Hero images for articles and landing pages
+- Technical diagrams and architecture illustrations
+- Infographics (data, process, comparison, timeline)
+- Screenshots and UI mockups
+- Video content for demos and tutorials
+
+## Supported Services
+
+| Service | Type | Cost | Best For |
+|---------|------|------|----------|
+| Gemini 2.5 Flash | Image | $0.02 | Fast, diagrams, general use |
+| Imagen 3 | Image | $0.03 | Premium quality heroes |
+| DALL-E 3 | Image | $0.04-0.12 | Creative, artistic |
+| GPT Image 1.5 | Image | $0.02 | Text-heavy visuals |
+| FLUX 2 Pro | Image | $0.03 | Detailed illustrations |
+| Veo 3 | Video | $0.10 | Product demos, tutorials |
+
+## Image Types
+
+| Type | Description | Recommended Service |
+|------|-------------|---------------------|
+| `hero` | Article header, main theme | FLUX 2 Pro / Imagen |
+| `illustration` | Abstract concepts, metaphors | FLUX 2 Pro |
+| `diagram` | Technical workflows, architecture | Gemini |
+| `screenshot` | UI mockups, interface designs | GPT Image 1.5 |
+| `infographic-data` | Statistics, metrics, charts | GPT Image 1.5 |
+| `infographic-process` | Step flows, workflows | FLUX 2 Pro |
+| `infographic-comparison` | Side-by-side comparisons | GPT Image 1.5 |
+| `infographic-timeline` | Chronological events | FLUX 2 Pro |
+| `architecture-diagram` | System design, tech stacks | Gemini |
+| `flowchart` | Decision trees, processes | Gemini |
+| `sequence-diagram` | API/service interactions | Gemini |
+| `video` | Product demos, tutorials | Veo 3 |
+
+## Prerequisites
+
+- At least one API key configured:
+  - `GOOGLE_API_KEY` (for Gemini, Imagen, Veo)
+  - `OPENAI_API_KEY` (for DALL-E, GPT Image)
+  - `FAL_KEY` (for FLUX 2 Pro)
+
+Run `/myai-configure visual` to set up API keys.
+
+## Process
+
+1. **Configuration Check**: Verify API keys are configured
+2. **Requirements Gathering**: Collect prompt, type, and preferences
+3. **Cost Estimation**: Show estimated cost and check budget
+4. **Generation**: Generate image/video using selected service
+5. **Asset Management**: Save to organized directory structure
+6. **Markdown Reference**: Return embed code for content
+
+## File Organization
+
+```
+content-assets/
+  ├── images/
+  │   └── YYYY-MM-DD/
+  │       └── {type}-{description}-{id}.png
+  └── videos/
+      └── YYYY-MM-DD/
+          └── video-{description}-{id}.mp4
+```
+
+## Parameters
+
+| Parameter | Description | Default |
+|-----------|-------------|---------|
+| `prompt` | What the image/video should depict | Required |
+| `--type` | Image type (see table above) | hero |
+| `--service` | Preferred generation service | auto |
+| `--quality` | low, medium, high | medium |
+| `--size` | 1024x1024, 1792x1024, 1024x1792 | 1024x1024 |
+| `--description` | Short description for filename | auto |
+
+## Budget Management
+
+The skill tracks daily and monthly spending:
+- Default daily budget: $5.00
+- Default monthly budget: $50.00
+
+Configure limits in `.env`:
+```
+VISUAL_DAILY_BUDGET=10.00
+VISUAL_MONTHLY_BUDGET=100.00
+```
+
+## HTML Conversion Alternative
+
+For data-driven visuals requiring pixel-perfect accuracy, use HTML conversion instead of AI generation:
+
+| Use Case | Tool |
+|----------|------|
+| Exact numbers/data | HTML Conversion |
+| Precise text labels | HTML/D2 Conversion |
+| Charts and graphs | HTML Conversion |
+| Creative/artistic | AI Generation |
+
+## Example Usage
+
+```bash
+# Basic hero image
+/myaidev-method:generate-visual "Modern developer workspace" --type=hero
+
+# Technical diagram
+/myaidev-method:generate-visual "Microservices architecture with API gateway" --type=architecture-diagram --service=gemini
+
+# Data infographic
+/myaidev-method:generate-visual "5 Key API Metrics: Latency <50ms, Uptime 99.99%" --type=infographic-data --service=gpt-image-1.5
+
+# Video content
+/myaidev-method:generate-visual "Product demo showing login flow" --type=video --service=veo3
+
+# Legacy command
+/myai-generate-visual "Abstract AI concept" --type=illustration
+```
+
+## Integration
+
+- Works with `/myaidev-method:content-writer` via `--with-images` flag
+- Automatic asset organization and cost tracking
+- Markdown reference generation for easy embedding
+
+## Error Handling
+
+- Rate limiting: Wait 60 seconds and retry, or switch service
+- Budget exceeded: Shows usage and suggests increasing limits
+- API errors: Provides helpful guidance and alternatives
+
+Always prioritize user experience, cost transparency, and quality results.

package/skills/wordpress-publisher/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: wordpress-publisher
+description: Publish and manage content on WordPress sites with full REST API integration
+argument-hint: [file.md] [--status=draft] [--category=blog]
+allowed-tools: [Read, Write, Bash, mcp__myaidev__wp_*]
+user-invocable: true
+category: publishing
+version: 1.0.0
+platforms: [claude-code, gemini-cli, codex-cli]
+---
+
+# WordPress Publisher Skill
+
+Publish and manage content on WordPress sites using the WordPress REST API with session management and full MCP integration.
+
+## Capabilities
+
+- Publish markdown content as WordPress posts/pages
+- Create drafts for review before publishing
+- Manage categories, tags, and featured images
+- Update existing posts
+- Session management for secure API access
+- Health checks and connection validation
+
+## Prerequisites
+
+Configure WordPress credentials:
+
+```bash
+/myai-configure wordpress
+```
+
+Or set environment variables:
+```
+WORDPRESS_URL=https://your-site.com
+WORDPRESS_USERNAME=your-username
+WORDPRESS_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx
+```
+
+### Creating an Application Password
+
+1. Log into WordPress admin
+2. Go to Users → Profile
+3. Scroll to "Application Passwords"
+4. Enter a name (e.g., "MyAIDev Method")
+5. Click "Add New Application Password"
+6. Copy the generated password (shown only once)
+
+## MCP Tools Available
+
+| Tool | Description |
+|------|-------------|
+| `wp_session_create` | Create authenticated session |
+| `wp_health_check` | Verify connection and authentication |
+| `wp_create_post` | Create new post from markdown |
+| `wp_update_post` | Update existing post |
+| `wp_get_posts` | List posts with filters |
+| `wp_get_categories` | Get available categories |
+| `wp_get_tags` | Get available tags |
+| `wp_upload_media` | Upload images/media |
+| `wp_memory_store` | Store session data |
+
+## Process
+
+1. **Session Creation**: Authenticate with WordPress
+2. **Content Parsing**: Extract frontmatter and content from markdown
+3. **Media Upload**: Upload any referenced images
+4. **Post Creation**: Create post via REST API
+5. **Verification**: Confirm successful publication
+6. **URL Return**: Provide the published/draft URL
+
+## Markdown Format
+
+Content should include frontmatter:
+
+```markdown
+---
+title: Your Post Title
+meta_description: SEO description (optional)
+slug: url-friendly-slug (optional)
+category: Blog (optional)
+tags: [tag1, tag2] (optional)
+featured_image: ./path/to/image.png (optional)
+---
+
+# Your Post Title
+
+Your content here...
+```
+
+## Parameters
+
+| Parameter | Description | Default |
+|-----------|-------------|---------|
+| `file` | Path to markdown file | Required |
+| `--status` | draft, publish, pending, private | draft |
+| `--category` | Post category | Uncategorized |
+| `--tags` | Comma-separated tags | none |
+| `--author` | Author ID | current user |
+| `--featured-image` | Path to featured image | none |
+
+## Example Usage
+
+```bash
+# Publish as draft
+/myaidev-method:wordpress-publish "./content/my-article.md" --status=draft
+
+# Publish immediately
+/myaidev-method:wordpress-publish "./content/my-article.md" --status=publish --category=tutorials
+
+# With featured image
+/myaidev-method:wordpress-publish "./content/my-article.md" --featured-image="./images/hero.png"
+
+# Legacy command
+/myai-wordpress-publish "./content/my-article.md"
+```
+
+## Integration
+
+- Works with `/myaidev-method:content-writer` via `--publish-wordpress` flag
+- Works with `/myaidev-method:coordinate-content` for batch publishing
+- Supports content verification before publishing
+
+## Gutenberg Block Support
+
+The publisher automatically converts markdown to Gutenberg blocks:
+
+- Headings → `core/heading`
+- Paragraphs → `core/paragraph`
+- Code blocks → `core/code`
+- Images → `core/image`
+- Lists → `core/list`
+- Blockquotes → `core/quote`
+- Tables → `core/table`
+
+## Error Handling
+
+| Error | Solution |
+|-------|----------|
+| 401 Unauthorized | Check credentials, regenerate app password |
+| 403 Forbidden | Verify user has publish_posts capability |
+| Connection refused | Check WordPress URL and server status |
+| Media upload failed | Check file permissions and upload limits |
+
+## Security Notes
+
+- Never commit credentials to version control
+- Use application passwords instead of main password
+- Store credentials in `.env` file (add to `.gitignore`)
+- Use HTTPS for all WordPress connections