VibeSKU CLI
Command-line interface for VibeSKU — AI-powered creative automation that turns product SKU photos into agency-grade e-commerce visuals and marketplace-ready copy in seconds.
What VibeSKU Does
VibeSKU replaces manual creative production for e-commerce teams. Upload a product photo, define brand guidelines, and receive complete multi-format visual sets. Core capabilities: VisionKV™ visual system (complete visual collections from a single product), high-fidelity product restoration (1:1 precision on textures/logos/packaging), multilingual text overlays, and omni-channel format output.
Credit costs: 1K/2K image = 1 credit, 4K image = 2 credits, short video = 5 credits, copy = 1 credit.
Setup
The CLI is bundled at bin/vibesku.js — self-contained Node.js script, zero dependencies (requires Node >= 18).
node <skill-dir>/bin/vibesku.js --help
alias vibesku="node <skill-dir>/bin/vibesku.js" # optional
Skill Version
For version checks and auto-update workflow, see versioning.md.
Authentication
Two methods, resolved in priority order:
- CLI token (
vibesku auth login) — browser-based device flow, tokens at ~/.vibesku/config.json
- API key —
VIBESKU_API_KEY env var > config file key (from vibesku init or vibesku config set-key)
vibesku auth login # Browser login (recommended)
vibesku init vsk_<key> # API key for CI/CD
Template Selection Guide
VibeSKU provides 7 templates. Read the corresponding reference file before building the generate command.
| Need |
Template |
Output |
Cost |
Reference |
| Single product image (main photo, banner, poster) |
ecom-hero |
IMAGE |
1-2 cr/img |
ecom-hero.md |
| Coordinated detail-page poster set |
kv-image-set |
IMAGE |
1-2 cr/img × scenes |
kv-image-set.md |
| Single technical exploded infographic |
exploded-view |
IMAGE |
1-2 cr/img |
exploded-view.md |
| Translate text inside an existing image/poster |
image-translation |
IMAGE |
1-2 cr/img |
image-translation.md |
| Product in a realistic usage scene |
lifestyle-scene |
IMAGE |
1-2 cr/img |
lifestyle-scene.md |
| Clean white-background packshot |
white-background |
IMAGE |
1-2 cr/img |
white-background.md |
| Product listing copy (title, bullets, description) |
listing |
TEXT |
1 cr |
listing.md |
Decision Tree
User wants visuals?
├── Technical exploded infographic → exploded-view
│ ├── Balanced callouts (default) → labelPlacement: balanced-callout
│ ├── Cleaner visual without labels → labelPlacement: none
│ └── Category-aware environment → backgroundMode: product-matched-scene
├── Existing image/poster needs visible text translated → image-translation
│ ├── Keep layout exactly → translationMode: faithful
│ ├── Make copy more natural → translationMode: polished
│ └── Preserve logos/trademarks → brandTextMode: preserve
├── Product photo needs a realistic usage scene → lifestyle-scene
│ ├── Let model infer scene → scenePreset: auto
│ ├── Specific setting → scenePreset: kitchen/outdoor/cafe/office/etc.
│ └── Human interaction → personMode: hand-only or full-figure
├── Marketplace/catalog white-background packshot → white-background
│ ├── Pure white background → backgroundTone: pure-white
│ ├── Softer depth → backgroundTone: soft-white
│ └── Tighter framing → cropMode: close-up
├── Single image (hero/banner/poster) → ecom-hero
│ ├── Product main photo → scenario: MAIN_IMAGE, aspectRatio: 1:1
│ ├── Marketing banner → scenario: BANNER, aspectRatio: 16:9
│ └── Vertical poster → scenario: POSTER, aspectRatio: 3:4
└── Multiple coordinated images → kv-image-set
├── Full detail page → scenes: [kv-hero, lifestyle, detail-01, specs-table, ...]
├── Quick hero + lifestyle → scenes: [kv-hero, lifestyle]
└── Brand storytelling → scenes: [kv-hero, brand-story, user-review]
User wants text?
└── Product listing copy → listing
├── Amazon → templateName: AMAZON_LISTING
├── Taobao → templateName: TAOBAO_DETAIL
├── Shopify → templateName: SHOPIFY_DESC
└── General → templateName: GENERIC
Quick Style Matching (image templates)
| Product Type |
ecom-hero style |
kv-image-set style |
exploded-view style |
lifestyle-scene style |
| Electronics, gadgets |
tech |
tech-future |
premium-technical |
tech |
| Luxury, high-end |
premium |
magazine |
morandi-editorial |
premium |
| Food, home goods |
lifestyle |
retro-film |
lifestyle-soft |
lifestyle |
| Organic, eco-friendly |
organic |
organic-nature |
material-focus |
organic |
| Fashion, beauty |
minimal |
nordic-minimal |
studio-minimal |
minimal |
| Kids, sports, bold |
vibrant |
cyberpunk |
auto (recommended) |
vibrant |
| Artisan, handmade |
studio |
watercolor |
material-focus |
studio |
| Unsure / let AI decide |
auto (default) |
auto (default) |
auto (default) |
auto (default) |
Typical Workflow
vibesku auth login # 1. Authenticate
vibesku templates # 2. Browse templates
vibesku templates info exploded-view # 3. Inspect template details (optional)
vibesku credits # 4. Check balance
vibesku generate -t ecom-hero \
-n "Wireless Headphones" \
-i product.jpg -l logo.png \
-b "AudioTech" # 5. Generate visuals
vibesku status <job-id> --watch # 6. Monitor until complete
vibesku refine <output-uuid> -p "brighter bg" # 7. Refine (optional)
vibesku export <job-id> -o ./output # 8. Download results
Commands Quick Reference
| Command |
Purpose |
vibesku auth login|logout|status|refresh |
Authentication management |
vibesku init <api-key> |
Initialize with API key |
vibesku config set-key|set-url|show|reset |
CLI configuration |
vibesku templates [info <id>] |
List / inspect templates |
vibesku generate -t <id> [options] |
Generate visuals or copy |
vibesku refine <output-id> -p <prompt> |
Refine output with edit instructions |
vibesku status <job-id> [--watch] |
Check job progress |
vibesku jobs [-p <page>] [-t <template>] |
List jobs |
vibesku export <job-id> [-o <dir>] |
Download outputs |
vibesku batch <file> [--dry-run] |
Bulk generation from JSON |
vibesku credits [show|buy|redeem <code>] |
Credit management |
All commands support --json for machine-readable output. Full details: commands.md
Key Behaviors
- Asset upload:
-i auto-uploads product images; -l uploads logo
- Modify vs Regenerate: Use
vibesku refine <output-id> -p "<instruction>" to edit existing output. Use vibesku generate only for new creations.
- Full UUID required for refine: Use
vibesku status <job-id> --json to get complete output UUIDs (table view truncates them).
- Agent-friendly output: Prefer
--json flag for all commands when used by AI agents.
- Version drift check (recommended triggers): Compare local
VERSION with upstream when any of these happen: unknown template/option error, template mismatch with vibesku templates --json, user asks for newly added capability, or local check is older than 7 days (recommended cadence). If issues occur during execution, prioritize this check before retrying generation/refine commands. Follow versioning.md.
- Auto-update when outdated (recommended): If upstream version is newer, update skill first, then continue the user task with the updated skill.
- Watch mode:
--watch polls every 5s until all runs complete.
- Credit tracking: Generation and refine show remaining balance on success.
Environment Variables
| Variable |
Description |
VIBESKU_API_KEY |
API key (overrides config file) |
VIBESKU_BASE_URL |
Custom API URL (overrides config file) |
NO_COLOR |
Disable colored output |
1---2name: vibesku3description: |4 VibeSKU CLI skill for generating e-commerce visuals and listing copy from product photos.5 Use when users need template-based generation (`ecom-hero`, `kv-image-set`, `exploded-view`,6 `image-translation`, `lifestyle-scene`, `white-background`, `listing`), refinement, export/download, batch jobs, auth setup, or7 credits/config management. Triggers on requests mentioning VibeSKU workflows, product image8 generation, hero banners, exploded views, image/poster translation, white-background packshots,9 listing copy, or batch runs.10metadata:11 source: https://skillmd.com/skills/ullrai/vibesku12 openclaw:13 requires:14 env:15 - VIBESKU_API_KEY16 - VIBESKU_BASE_URL17 - NO_COLOR18 bins:19 - node20 config:21 - ~/.vibesku/config.json22 primaryEnv: VIBESKU_API_KEY23 homepage: https://www.vibesku.com24---2526# VibeSKU CLI2728Command-line interface for [VibeSKU](https://www.vibesku.com) — AI-powered creative automation that turns product SKU photos into agency-grade e-commerce visuals and marketplace-ready copy in seconds.2930## What VibeSKU Does3132VibeSKU replaces manual creative production for e-commerce teams. Upload a product photo, define brand guidelines, and receive complete multi-format visual sets. Core capabilities: VisionKV™ visual system (complete visual collections from a single product), high-fidelity product restoration (1:1 precision on textures/logos/packaging), multilingual text overlays, and omni-channel format output.3334**Credit costs**: 1K/2K image = 1 credit, 4K image = 2 credits, short video = 5 credits, copy = 1 credit.3536## Setup3738The CLI is bundled at `bin/vibesku.js` — self-contained Node.js script, zero dependencies (requires Node >= 18).3940```bash41node <skill-dir>/bin/vibesku.js --help42alias vibesku="node <skill-dir>/bin/vibesku.js" # optional43```4445## Skill Version4647- Source of truth: `VERSION`48- Local version: `cat VERSION`49- Upstream repo: [UllrAI/vibesku-agent](https://github.com/UllrAI/vibesku-agent)5051For version checks and auto-update workflow, see [versioning.md](references/versioning.md).5253## Authentication5455Two methods, resolved in priority order:56571. **CLI token** (`vibesku auth login`) — browser-based device flow, tokens at `~/.vibesku/config.json`582. **API key** — `VIBESKU_API_KEY` env var > config file key (from `vibesku init` or `vibesku config set-key`)5960```bash61vibesku auth login # Browser login (recommended)62vibesku init vsk_<key> # API key for CI/CD63```6465---6667## Template Selection Guide6869VibeSKU provides 7 templates. **Read the corresponding reference file before building the generate command.**7071| Need | Template | Output | Cost | Reference |72|------|----------|--------|------|-----------|73| Single product image (main photo, banner, poster) | `ecom-hero` | IMAGE | 1-2 cr/img | [ecom-hero.md](references/ecom-hero.md) |74| Coordinated detail-page poster set | `kv-image-set` | IMAGE | 1-2 cr/img × scenes | [kv-image-set.md](references/kv-image-set.md) |75| Single technical exploded infographic | `exploded-view` | IMAGE | 1-2 cr/img | [exploded-view.md](references/exploded-view.md) |76| Translate text inside an existing image/poster | `image-translation` | IMAGE | 1-2 cr/img | [image-translation.md](references/image-translation.md) |77| Product in a realistic usage scene | `lifestyle-scene` | IMAGE | 1-2 cr/img | [lifestyle-scene.md](references/lifestyle-scene.md) |78| Clean white-background packshot | `white-background` | IMAGE | 1-2 cr/img | [white-background.md](references/white-background.md) |79| Product listing copy (title, bullets, description) | `listing` | TEXT | 1 cr | [listing.md](references/listing.md) |8081### Decision Tree8283```84User wants visuals?85├── Technical exploded infographic → exploded-view86│ ├── Balanced callouts (default) → labelPlacement: balanced-callout87│ ├── Cleaner visual without labels → labelPlacement: none88│ └── Category-aware environment → backgroundMode: product-matched-scene89├── Existing image/poster needs visible text translated → image-translation90│ ├── Keep layout exactly → translationMode: faithful91│ ├── Make copy more natural → translationMode: polished92│ └── Preserve logos/trademarks → brandTextMode: preserve93├── Product photo needs a realistic usage scene → lifestyle-scene94│ ├── Let model infer scene → scenePreset: auto95│ ├── Specific setting → scenePreset: kitchen/outdoor/cafe/office/etc.96│ └── Human interaction → personMode: hand-only or full-figure97├── Marketplace/catalog white-background packshot → white-background98│ ├── Pure white background → backgroundTone: pure-white99│ ├── Softer depth → backgroundTone: soft-white100│ └── Tighter framing → cropMode: close-up101├── Single image (hero/banner/poster) → ecom-hero102│ ├── Product main photo → scenario: MAIN_IMAGE, aspectRatio: 1:1103│ ├── Marketing banner → scenario: BANNER, aspectRatio: 16:9104│ └── Vertical poster → scenario: POSTER, aspectRatio: 3:4105└── Multiple coordinated images → kv-image-set106 ├── Full detail page → scenes: [kv-hero, lifestyle, detail-01, specs-table, ...]107 ├── Quick hero + lifestyle → scenes: [kv-hero, lifestyle]108 └── Brand storytelling → scenes: [kv-hero, brand-story, user-review]109110User wants text?111└── Product listing copy → listing112 ├── Amazon → templateName: AMAZON_LISTING113 ├── Taobao → templateName: TAOBAO_DETAIL114 ├── Shopify → templateName: SHOPIFY_DESC115 └── General → templateName: GENERIC116```117118### Quick Style Matching (image templates)119120| Product Type | ecom-hero `style` | kv-image-set `style` | exploded-view `style` | lifestyle-scene `style` |121|-------------|-------------------|---------------------|------------------------|---------------------------|122| Electronics, gadgets | `tech` | `tech-future` | `premium-technical` | `tech` |123| Luxury, high-end | `premium` | `magazine` | `morandi-editorial` | `premium` |124| Food, home goods | `lifestyle` | `retro-film` | `lifestyle-soft` | `lifestyle` |125| Organic, eco-friendly | `organic` | `organic-nature` | `material-focus` | `organic` |126| Fashion, beauty | `minimal` | `nordic-minimal` | `studio-minimal` | `minimal` |127| Kids, sports, bold | `vibrant` | `cyberpunk` | `auto` (recommended) | `vibrant` |128| Artisan, handmade | `studio` | `watercolor` | `material-focus` | `studio` |129| Unsure / let AI decide | `auto` (default) | `auto` (default) | `auto` (default) | `auto` (default) |130131---132133## Typical Workflow134135```bash136vibesku auth login # 1. Authenticate137vibesku templates # 2. Browse templates138vibesku templates info exploded-view # 3. Inspect template details (optional)139vibesku credits # 4. Check balance140vibesku generate -t ecom-hero \141 -n "Wireless Headphones" \142 -i product.jpg -l logo.png \143 -b "AudioTech" # 5. Generate visuals144vibesku status <job-id> --watch # 6. Monitor until complete145vibesku refine <output-uuid> -p "brighter bg" # 7. Refine (optional)146vibesku export <job-id> -o ./output # 8. Download results147```148149## Commands Quick Reference150151| Command | Purpose |152|---------|---------|153| `vibesku auth login\|logout\|status\|refresh` | Authentication management |154| `vibesku init <api-key>` | Initialize with API key |155| `vibesku config set-key\|set-url\|show\|reset` | CLI configuration |156| `vibesku templates [info <id>]` | List / inspect templates |157| `vibesku generate -t <id> [options]` | Generate visuals or copy |158| `vibesku refine <output-id> -p <prompt>` | Refine output with edit instructions |159| `vibesku status <job-id> [--watch]` | Check job progress |160| `vibesku jobs [-p <page>] [-t <template>]` | List jobs |161| `vibesku export <job-id> [-o <dir>]` | Download outputs |162| `vibesku batch <file> [--dry-run]` | Bulk generation from JSON |163| `vibesku credits [show\|buy\|redeem <code>]` | Credit management |164165All commands support `--json` for machine-readable output. Full details: [commands.md](references/commands.md)166167## Key Behaviors168169- **Asset upload**: `-i` auto-uploads product images; `-l` uploads logo170- **Modify vs Regenerate**: Use `vibesku refine <output-id> -p "<instruction>"` to edit existing output. Use `vibesku generate` only for new creations.171- **Full UUID required for refine**: Use `vibesku status <job-id> --json` to get complete output UUIDs (table view truncates them).172- **Agent-friendly output**: Prefer `--json` flag for all commands when used by AI agents.173- **Version drift check (recommended triggers)**: Compare local `VERSION` with upstream when any of these happen: unknown template/option error, template mismatch with `vibesku templates --json`, user asks for newly added capability, or local check is older than 7 days (recommended cadence). If issues occur during execution, prioritize this check before retrying generation/refine commands. Follow [versioning.md](references/versioning.md).174- **Auto-update when outdated (recommended)**: If upstream version is newer, update skill first, then continue the user task with the updated skill.175- **Watch mode**: `--watch` polls every 5s until all runs complete.176- **Credit tracking**: Generation and refine show remaining balance on success.177178## Environment Variables179180| Variable | Description |181|----------|-------------|182| `VIBESKU_API_KEY` | API key (overrides config file) |183| `VIBESKU_BASE_URL` | Custom API URL (overrides config file) |184| `NO_COLOR` | Disable colored output |