@scenerok/cli 1.0.4 → 1.0.6

package/skills/skills/codex/vidscript-sample.md

@@ -0,0 +1,30 @@
+# VidScript v2 Sample — Product promo with generated video
+
+Copy this shape for promos that use xAI-generated clips. Run `scenerok validate` before `scenerok render`.
+
+```vidscript
+import xai from "@scenerok/xai"
+import motion from "@scenerok/basic-animations"
+
+input product_name = "{{product_name | RokMilk}}"
+input hook_text = "{{hook_text | Chocolate Milkshake}}"
+input cta_text = "{{cta_text | visit your nearest grocery store}}"
+
+[0s .. 2.5s] = text product_name, font: "Bebas Neue", size: 80, color: "#FFD700", x: "50%", y: "20%", align: center, stroke: "#3E1C00", stroke_width: 4, animate: motion.fadeIn(0.6s)
+
+[2s .. 4.5s] = text hook_text, font: "Outfit", size: 52, color: "#FFFFFF", x: "50%", y: "45%", align: center, stroke: "#3E1C00", stroke_width: 3, animate: motion.riseIn(0.8s)
+
+[-] = video xai.imagine(
+    "Premium lifestyle product shot of " + product_name + " chocolate milk in 250ml carton, cinematic lighting, 9:16 vertical",
+    aspect_ratio: "9:16",
+    duration: 6
+)
+
+[8s .. 11s] = text cta_text, font: "Bebas Neue", size: 48, color: "#FFD700", x: "50%", y: "80%", align: center, stroke: "#3E1C00", stroke_width: 4, animate: motion.fadeIn(0.8s)
+
+[0s .. 12s] = filter "vignette", intensity: 0.3
+
+output to "product-promo.mp4", resolution: "1080x1920", fps: 30
+```
+
+For clips you already have (no xAI), start from `examples/system/product-launch.vid` instead.

package/skills/skills/codex/vidscript-strict.md

@@ -0,0 +1,113 @@
+# VidScript v2 — Strict Agent Reference
+
+Follow these rules exactly. When in doubt, copy a file from `examples/system/` (installed with `scenerok skills install`).
+
+## Rule 1: Package imports are mandatory
+
+```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
+```
+
+Without the owning import, calls like `xai.imagine`, `xai.tts`, `eleven.music`, and `motion.fadeIn` fail validation.
+
+**Never** call package functions without importing the package alias first.
+
+## Rule 2: Use registered plugin surfaces
+
+```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+
+[-] = video xai.imagine("Prompt here", aspect_ratio: "9:16", duration: 5)
+[-] = audio xai.tts("Voiceover line", voice: "eve")
+[0s .. 15s] = audio eleven.music("Warm premium music bed", duration: 15, instrumental: true)
+```
+
+For ElevenLabs music, import `@elevenlabs/music` and use `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`.
+
+## Rule 3: Time ranges use `..`
+
+```vidscript
+[0s .. 5s] = text "Hello"
+```
+
+Not `[0s - 5s]`.
+
+## Rule 4: Text params stay on one line
+
+```vidscript
+[0.5s .. 3s] = text "Headline", font: "Inter", size: 64, color: "#FFFFFF", x: "50%", y: "30%", align: center
+```
+
+## Rule 5: Quote safety in prompts
+
+Use only straight `"` inside `xai.imagine("...")`. Do not nest quotes inside the prompt string (e.g. avoid `"RokMilk"` inside the prompt — say `labeled RokMilk` without extra quotes).
+
+## Rule 6: Audio syntax
+
+```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+
+[-] = audio xai.tts("Spoken line", voice: "eve", speed: 1.0)
+
+# Direct music call, no trailing audio params.
+[0s .. 15s] = audio eleven.music("Soft premium ad music", duration: 15, instrumental: true)
+
+# Use a binding when you need volume or fades.
+let bed = eleven.music("Soft premium ad music", duration: 15, instrumental: true)
+[0s .. 15s] = audio bed, volume: 0.35, fade_out: 2s
+```
+
+**Invalid:** `audio eleven.music("...", duration: 15), volume: 0.35` — trailing `, volume` after a direct plugin call is a parse error.
+
+**Invalid:** `eleven.generateMusic(...)` without `import eleven from "@elevenlabs/music"`.
+
+## Rule 7: Filters
+
+```vidscript
+[0s .. 15s] = filter "vignette", intensity: 0.3
+[0s .. 15s] = filter "saturation", value: 1.12
+```
+
+`saturation` uses `value`, not `intensity`.
+
+## Rule 8: Always end with output
+
+```vidscript
+output to "video.mp4", resolution: "1080x1920", fps: 30
+```
+
+Do **not** use legacy `config { }` blocks — they are not part of VidScript v2.
+
+## Animations (after import)
+
+```vidscript
+import motion from "@scenerok/basic-animations"
+
+[0s .. 2s] = text "Launch", x: "50%", y: "50%", animate: motion.popIn(0.7s)
+```
+
+Available: `fadeIn`, `fadeOut`, `slideX`, `slideY`, `popIn`, `riseIn`, `swingIn`, `glitchIn`, `float`, `typewriter`.
+
+## Validate before render
+
+```bash
+scenerok validate my-video.vid
+```
+
+Each error line includes `Line N:C — message` when the server returns location info.
+
+## Bundled examples
+
+| File | Use case |
+|------|----------|
+| `minimal-text-reel.vid` | Text-only, no API keys |
+| `product-launch.vid` | User video input + text + vignette |
+| `ecom-product-launch.vid` | xAI product visuals + CTA |
+| `3-tips-fitness.vid` | Multiple `[-]` blocks + xAI per segment |
+| `rokmilk-chocolate-promo.vid` | 15s generated-video promo pattern |
+
+Full grammar: https://scenerok.com/docs/vidscript

package/skills/skills/cursor/SKILL.md

@@ -0,0 +1,185 @@
+---
+name: scenerok
+description: >-
+  Compose VidScript v2 scripts and render videos with the SceneRok CLI
+  (scenerok validate, render, status). Use when the user asks to create
+  promos, reels, social videos, product launches, or mentions VidScript,
+  SceneRok, scenerok CLI, or terminal/agent video generation.
+---
+
+# SceneRok Skill for Cursor
+
+## Overview
+
+You are a VidScript composer and video generation expert integrated with Cursor. You help users create video content using the SceneRok platform directly from their terminal.
+
+## Capabilities
+
+- Compose VidScript files for video generation
+- Validate VidScript syntax before rendering
+- Submit render jobs to SceneRok
+- Check render status and retrieve output
+- Guide users through video creation workflows
+- Fill template placeholders and customize system templates
+
+## VidScript Language
+
+VidScript is a declarative language for describing video compositions using time blocks, inputs, text overlays, video operations, filters, and compositing.
+
+### Core Concepts
+
+**Inputs** - Declare video sources:
+```vidscript
+input hero = "https://cdn.example.com/hero.mp4"
+input logo = "/uploads/logo.png"
+```
+
+**Time Blocks** - Define what happens during a time range:
+```vidscript
+[-] = hero                               # auto-append: starts after previous block
+hero.Trim(start: 0s, end: 5s)
+
+[- 3s] = text "Hello", style: title, color: "#FFF"   # auto-start, 3s duration
+[0s .. 5s] = hero                                     # explicit range
+[prev + 0.5s .. prev + 2s] = filter "glow"            # expression-based
+```
+
+**Video Operations** - Modify how video plays:
+```vidscript
+hero.Trim(start: 0s, end: 5s)      # trim clip
+hero.Speed(factor: 1.5)             # 50% faster
+hero.Resize(width: 1080, height: 1920)
+hero.Loop(count: 3)                 # play 3 times
+hero.Opacity(value: 0.5, duration: 2s)
+```
+
+**Compositing** - Layer videos:
+```vidscript
+base.Overlay(logo, x: 50, y: 50, opacity: 0.8)
+```
+
+**Filters & Shaders** - Post-processing effects:
+```vidscript
+[0s .. 5s] = filter "vignette", intensity: 0.4
+[2s .. 4s] = filter "sepia", intensity: 0.6
+```
+
+Built-in filters: `monochrome`, `sepia`, `blur`, `chromatic`, `glitch`, `vignette`, `contrast`, `saturation`, `brightness`
+
+**Text Overlays** - Add on-screen text:
+```vidscript
+[0.5s .. 3s] = text "Headline", style: title, position: center, color: "#FFF", size: 72, stroke: "#000", stroke_width: 3
+```
+
+**Output** - Specify render settings:
+```vidscript
+output to "video.mp4", resolution: "1080x1920", fps: 30
+```
+
+### Package Imports
+
+```vidscript
+import xai from "@scenerok/xai"                    # xAI image/video/tts
+import eleven from "@elevenlabs/music"          # ElevenLabs generative music
+import motion from "@scenerok/basic-animations" # text/video animation helpers
+```
+
+### Plugin Calls
+
+```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
+
+[-] = video xai.imagine("Cinematic product shot", aspect_ratio: "9:16", duration: 5)
+[-] = audio xai.tts("Welcome to SceneRok", voice: "eve")
+
+# ElevenLabs music package functions require an import alias.
+let bed = eleven.music("Warm premium launch bed", duration: 15, instrumental: true)
+[0s .. 15s] = audio bed, volume: 0.35, fade_out: 2s
+```
+
+**Always** import the package that owns the function: `xai.*` from `@scenerok/xai`, `eleven.*` from `@elevenlabs/music`, and `motion.*` from `@scenerok/basic-animations`. Calls without import fail validation with `Unknown function 'xai.imagine'`.
+
+For ElevenLabs music, import `@elevenlabs/music` and call `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`. Use `let bed = eleven.music(...)` followed by `audio bed, volume: ...` when you need volume or fades.
+
+Read `vidscript-strict.md` for anti-patterns and `examples/system/*.vid` for copy-paste templates (installed with `scenerok skills install`).
+
+### Placeholders
+
+Templates use `{{name | default}}` for user-supplied values:
+```vidscript
+input hero = "{{hero_clip}}"
+[0.5s .. 3s] = text "{{headline | Hello}}", style: title
+```
+
+## Workflow
+
+1. **Understand the goal** — What video does the user want? (promo, testimonial, meme, etc.)
+2. **Plan the structure** — Time blocks, durations, inputs
+3. **Gather assets** — Video URLs or local paths
+4. **Compose VidScript** — Write the full script
+5. **Validate** — Run `scenerok validate script.vid`
+6. **Render** — Run `scenerok render script.vid --watch`
+7. **Deliver** — Share the download URL when complete
+
+## Best Practices
+
+- **Use dynamic timeblocks** — `[-]` auto-advances the cursor, reducing calculation errors
+- **Use `prev` for offsets** — `[prev + 0.5s .. prev + 2s]` for gaps between content
+- **Named arguments for clarity** — `hero.Trim(start: 0s, end: 5s)` over `hero.Trim(0s, 5s)`
+- Use 1080x1920 for vertical content (TikTok/Instagram)
+- Use 1920x1080 for horizontal content (YouTube)
+- Hook viewers in the first 3 seconds
+- Use high-contrast text on video backgrounds with `stroke` and `stroke_width`
+- Include a clear call-to-action
+- Test with `scenerok validate` before rendering
+- Each render costs 1 credit
+
+## CLI Commands
+
+```bash
+scenerok auth login              # Authenticate
+scenerok validate script.vid      # Validate a VidScript
+scenerok render script.vid --watch # Render a video
+scenerok status <render-id>       # Check status
+scenerok skills install <platform> # Install/update agent skill
+scenerok skills list               # List available skills
+scenerok secrets set KEY=VALUE    # Store API key for plugins
+```
+
+## Error Handling
+
+If a render fails:
+1. Check the error message with `scenerok status <id>`
+2. Common issues: missing assets (404 URLs), invalid file paths, syntax errors
+3. Fix the VidScript and re-render
+4. If credits are insufficient, the user needs to purchase more
+
+## Sample Video Types
+
+- **Product Promo** — Hero clip + headline + description + CTA + vignette filter
+- **Social Media Hook** — Fast cuts, bold text, speed adjustments
+- **Testimonial** — Speaker clip + quote text + sepia filter
+- **Meme Remix** — Reaction clip + top/bottom punchline overlays
+- **Title Sequence** — Background clip + glitch shader + bold typography
+
+Always ask clarifying questions about:
+- Target platform (TikTok, Instagram, YouTube, etc.)
+- Brand colors and fonts
+- Existing assets (video clips, logo, etc.)
+- Desired duration and style
+- Whether they want to start from a template or from scratch
+
+## Reference files (in this skill folder)
+
+| File | Purpose |
+|------|---------|
+| `vidscript-guide.md` | Full grammar reference |
+| `vidscript-strict.md` | **Read first** — rules that prevent common agent mistakes |
+| `vidscript-sample.md` | Minimal promo with xAI import |
+| `examples/system/*.vid` | Official SceneRok templates (text-only, product launch, xAI reels) |
+
+## Full Reference
+
+https://scenerok.com/docs/vidscript