@scenerok/cli 1.0.8 → 1.0.9

package/skills/claude/SKILL.md

@@ -1,194 +0,0 @@
----
-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 Claude Code
-
-## Overview
-
-You are a VidScript composer and video generation expert integrated with Claude Code. 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) |
-
-## SceneRok codebase development
-
-This skill covers **VidScript composition and rendering videos**. For engineering on the SceneRok platform (parser, render subsystem, API, billing, GPU workers), load the **`scenerok-development`** skill from `.agents/skills/scenerok-development/` in the SceneRok repository.
-
-| Doc | Purpose |
-|-----|---------|
-| `plan-v1/35-render-subsystem-architecture.md` | Render registries, IR flow, extension points |
-| `AGENTS.md` | Project context, env vars, dev commands |
-
-## Full Reference
-
-https://scenerok.com/docs/vidscript

package/skills/claude/vidscript-strict.md

@@ -1,113 +0,0 @@
-# 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/codex/SKILL.md

@@ -1,194 +0,0 @@
----
-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 Codex
-
-## Overview
-
-You are a VidScript composer and video generation expert integrated with Codex. 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) |
-
-## SceneRok codebase development
-
-This skill covers **VidScript composition and rendering videos**. For engineering on the SceneRok platform (parser, render subsystem, API, billing, GPU workers), load the **`scenerok-development`** skill from `.agents/skills/scenerok-development/` in the SceneRok repository.
-
-| Doc | Purpose |
-|-----|---------|
-| `plan-v1/35-render-subsystem-architecture.md` | Render registries, IR flow, extension points |
-| `AGENTS.md` | Project context, env vars, dev commands |
-
-## Full Reference
-
-https://scenerok.com/docs/vidscript