@scenerok/cli 1.0.8 → 1.0.9

package/dist/commands/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkIpC,eAAO,MAAM,aAAa,SA4DvB,CAAC"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwGpC,eAAO,MAAM,aAAa,SA4DvB,CAAC"}

package/dist/commands/skills.js

@@ -4,64 +4,39 @@ import { existsSync, copyFileSync, mkdirSync, readdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 function getPlatformConfig(platform) {
-    const cwd = process.cwd();
     const configs = {
         opencode: {
             name: 'OpenCode',
             skillDir: join(homedir(), '.agents/skills/scenerok'),
-            files: [
-                { source: 'skills/opencode/SKILL.md', dest: 'SKILL.md' },
-                { source: 'skills/opencode/vidscript-guide.md', dest: 'vidscript-guide.md' },
-                { source: 'skills/opencode/vidscript-sample.md', dest: 'vidscript-sample.md' },
-                { source: 'skills/opencode/vidscript-strict.md', dest: 'vidscript-strict.md' },
-            ],
         },
         claude: {
             name: 'Claude Code',
             skillDir: join(homedir(), '.claude/skills/scenerok'),
-            files: [
-                { source: 'skills/claude/SKILL.md', dest: 'SKILL.md' },
-                { source: 'skills/claude/vidscript-guide.md', dest: 'vidscript-guide.md' },
-                { source: 'skills/claude/vidscript-sample.md', dest: 'vidscript-sample.md' },
-                { source: 'skills/claude/vidscript-strict.md', dest: 'vidscript-strict.md' },
-            ],
         },
         codex: {
             name: 'Codex',
             skillDir: join(homedir(), '.codex/skills/scenerok'),
-            files: [
-                { source: 'skills/codex/SKILL.md', dest: 'SKILL.md' },
-                { source: 'skills/codex/vidscript-guide.md', dest: 'vidscript-guide.md' },
-                { source: 'skills/codex/vidscript-sample.md', dest: 'vidscript-sample.md' },
-                { source: 'skills/codex/vidscript-strict.md', dest: 'vidscript-strict.md' },
-            ],
         },
         cursor: {
             name: 'Cursor',
             skillDir: join(homedir(), '.cursor/skills/scenerok'),
-            files: [
-                { source: 'skills/cursor/SKILL.md', dest: 'SKILL.md' },
-                { source: 'skills/cursor/vidscript-guide.md', dest: 'vidscript-guide.md' },
-                { source: 'skills/cursor/vidscript-sample.md', dest: 'vidscript-sample.md' },
-                { source: 'skills/cursor/vidscript-strict.md', dest: 'vidscript-strict.md' },
-            ],
         },
         aider: {
             name: 'Aider',
             skillDir: join(homedir(), '.aider/skills/scenerok'),
-            files: [
-                { source: 'skills/aider/SKILL.md', dest: 'SKILL.md' },
-                { source: 'skills/aider/vidscript-guide.md', dest: 'vidscript-guide.md' },
-                { source: 'skills/aider/vidscript-sample.md', dest: 'vidscript-sample.md' },
-                { source: 'skills/aider/vidscript-strict.md', dest: 'vidscript-strict.md' },
-            ],
         },
     };
     return configs[platform] || null;
 }
+const sharedSkillFiles = [
+    'SKILL.md',
+    'vidscript-guide.md',
+    'vidscript-sample.md',
+    'vidscript-strict.md',
+].map((name) => ({ source: `skills/shared/${name}`, dest: name }));
 async function findSkillSource(sourcePath) {
-    // Check relative to node_modules/@scenerok/cli (scoped package)
-    const modulePath = join(dirname(new URL(import.meta.url).pathname), '../../../..', sourcePath);
+    // Check relative to the installed @scenerok/cli package.
+    const modulePath = join(dirname(new URL(import.meta.url).pathname), '../..', sourcePath);
     if (existsSync(modulePath))
         return modulePath;
     // Check relative to CWD
@@ -127,7 +102,7 @@ export const skillsCommand = new Command('skills')
     if (!existsSync(config.skillDir)) {
         mkdirSync(config.skillDir, { recursive: true });
     }
-    for (const file of config.files) {
+    for (const file of sharedSkillFiles) {
         const source = await findSkillSource(file.source);
         const dest = join(config.skillDir, file.dest);
         if (!source) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scenerok/cli",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "SceneRok CLI - Create videos from your terminal and agent workflows",
   "type": "module",
   "bin": {
@@ -16,7 +16,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "sync:skills": "node ../../scripts/sync-scenerok-skills.mjs",
+    "prepublishOnly": "npm run sync:skills && npm run build"
   },
   "keywords": [
     "scenerok",

package/skills/{aider → shared}/SKILL.md

@@ -7,11 +7,11 @@ description: >-
   SceneRok, scenerok CLI, or terminal/agent video generation.
 ---
 
-# SceneRok Skill for Aider
+# SceneRok Agent Skill
 
 ## Overview
 
-You are a VidScript composer and video generation expert integrated with Aider. You help users create video content using the SceneRok platform directly from their terminal.
+You are a VidScript composer and video generation expert integrated with your agent. You help users create video content using the SceneRok platform directly from their terminal.
 
 ## Capabilities
 
@@ -21,6 +21,7 @@ You are a VidScript composer and video generation expert integrated with Aider.
 - Check render status and retrieve output
 - Guide users through video creation workflows
 - Fill template placeholders and customize system templates
+- When the user gives a product or website URL, use available browser or screenshot tools to capture real site visuals for VidScript assets
 
 ## VidScript Language
 
@@ -28,7 +29,7 @@ VidScript is a declarative language for describing video compositions using time
 
 ### Core Concepts
 
-**Inputs** - Declare video sources:
+**Inputs** - Declare video/image sources:
 ```vidscript
 input hero = "https://cdn.example.com/hero.mp4"
 input logo = "/uploads/logo.png"
@@ -91,7 +92,7 @@ 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)
+[-] = video xai.imagine("Cinematic product shot, premium lighting, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", aspect_ratio: "9:16", duration: 5)
 [-] = audio xai.tts("Welcome to SceneRok", voice: "eve")
 
 # ElevenLabs music package functions require an import alias.
@@ -117,17 +118,37 @@ input hero = "{{hero_clip}}"
 
 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
+3. **Gather assets** — Video URLs, local paths, or captured website screenshots/images; when the user provides a URL, use browser screenshot capability if available
+4. **Probe asset dimensions** — Inspect every local or downloaded image/video before placing it. Use `ffprobe` for video/audio, `sips -g pixelWidth -g pixelHeight file` on macOS images, or `identify file` when ImageMagick is available.
+5. **Compose VidScript** — Write the full script using measured dimensions, aspect-ratio-preserving scale, centered/safe-area placement, and entry/exit animation beats for each visual asset
+6. **Validate** — Run `scenerok validate script.vid`
+7. **Render** — Run `scenerok render script.vid --watch`
+8. **Deliver** — Share the download URL when complete
+
+## Website URL Asset Workflow
+
+When the user provides a product, company, landing page, app store listing, or ecommerce URL, treat the site as the primary visual source for the video.
+
+1. Visit the URL with an available browser tool before composing the final VidScript.
+2. Capture screenshots of useful page states: hero section, product detail, pricing or offer section, testimonials, checkout/app preview, and any visual proof points.
+3. Detect and save usable product images, app screenshots, brand marks, and logos from the page when available. Prefer direct image assets only when they are accessible and clearly match the product; otherwise use browser screenshots.
+4. Probe saved asset dimensions before composing. Record width, height, aspect ratio, and duration if video; never guess dimensions from filenames or screenshots.
+5. Use those screenshots or images as VidScript input assets and build the ad from real product visuals. Crop, resize, overlay text, add filters, and sequence them into a promo.
+6. Scale assets from their measured aspect ratio to fit the output frame and safe areas. For 1080x1920 ads, keep primary visuals inside roughly 80-88% of frame width and reserve enough top/bottom room for text.
+7. Animate visual assets intentionally: use entry animations such as `motion.popIn`, `motion.riseIn`, or `motion.slideY`; use short exit fade/slide segments when a clean transition is needed. For static plates, split the asset into a main segment and a final 0.4-0.7s segment with `motion.fadeOut(...)` to create a real exit.
+8. Use generative visuals such as `xai.imagine` only as a fallback, background texture, transition, or supplemental shot when real website assets are missing, low quality, or the user explicitly asks for generated footage.
+9. For every generated visual prompt, explicitly require a clean scene with no text, no words, no letters, no captions, no logos, no watermarks, and no readable UI copy. AI video generation often corrupts text; all final titles, offers, captions, CTAs, prices, and labels must be created with VidScript `text` primitives.
+10. Do not invent product claims. Extract copy, pricing, feature names, social proof, and CTA language from the site or ask the user.
 
 ## 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)`
+- **Prefer real website assets for URL-based ads** — browser screenshots, product images, app screenshots, and logos should come before fully generative clips
+- **Probe before placing** — get exact dimensions for every real asset, calculate scale from aspect ratio, and set `width`, `height`, `x`, and `y` explicitly
+- **Animate assets, not only text** — give product screenshots/logos/cards a clear entrance and a clean exit; split static visuals into main and fade-out segments if needed
+- **Keep generated media text-free** — prompts for AI-generated images/videos must explicitly say no text, no words, no letters, no captions, no logos, no watermarks, and no readable UI copy; add all final copy with VidScript `text` primitives
 - Use 1080x1920 for vertical content (TikTok/Instagram)
 - Use 1920x1080 for horizontal content (YouTube)
 - Hook viewers in the first 3 seconds
@@ -167,7 +188,7 @@ If a render fails:
 Always ask clarifying questions about:
 - Target platform (TikTok, Instagram, YouTube, etc.)
 - Brand colors and fonts
-- Existing assets (video clips, logo, etc.)
+- Existing assets, product URLs, browser-captured screenshots, logos, and page images
 - Desired duration and style
 - Whether they want to start from a template or from scratch
 

package/skills/{claude → shared}/vidscript-guide.md

@@ -8,7 +8,11 @@ VidScript is a declarative DSL for composing short-form videos. Write a script,
 2. **Validate early** — `scenerok validate file.vid` (errors show as `Line N:C — message`).
 3. **Music package syntax** — `import eleven from "@elevenlabs/music"`, then call `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`.
 4. **Copy working examples** — see `examples/system/` in this skill folder (e.g. `minimal-text-reel.vid`, `ecom-product-launch.vid`, `rokmilk-chocolate-promo.vid`).
-5. **Strict rules** — see `vidscript-strict.md` for invalid patterns (bare `xai.imagine`, bare `eleven.music(...)` without import, trailing params after direct plugin calls, nested quotes in prompts).
+5. **URL assets first** — if the user gives a website or product URL and browser screenshot tools are available, capture real page screenshots, product images, app screenshots, and logos for VidScript `input` assets before using generated visuals.
+6. **Probe asset dimensions** — before placing real assets, inspect width, height, and duration with `ffprobe`, `sips`, or `identify`; then scale from the measured aspect ratio and set explicit `width`, `height`, `x`, and `y`.
+7. **Animate real assets** — visual inputs should have entry motion and, where transitions matter, an exit beat. For static plates, split into a main segment and a short final `motion.fadeOut(...)` segment.
+8. **Generated media has no text** — prompts for AI-generated images/videos must explicitly ask for no text, no words, no letters, no captions, no logos, no watermarks, and no readable UI copy. Use VidScript `text` primitives for all final copy.
+9. **Strict rules** — see `vidscript-strict.md` for invalid patterns (bare `xai.imagine`, bare `eleven.music(...)` without import, trailing params after direct plugin calls, nested quotes in prompts).
 
 ### Common validation failures
 
@@ -39,7 +43,28 @@ input hero = "https://cdn.example.com/hero.mp4"
 input logo = "./assets/logo.png"
 ```
 
-Supports HTTP(S) URLs, `/uploads/` paths, and local paths.
+Supports HTTP(S) URLs, `/uploads/` paths, and local paths for video/image assets.
+
+For ads based on a supplied URL, use browser tools to capture real website screenshots and save product images or logos when available. Declare those files as inputs and use them in the composition before reaching for generated clips.
+
+After declaring or downloading assets, probe dimensions before placing them:
+
+```bash
+ffprobe -v error -select_streams v:0 -show_entries stream=width,height,duration -of csv=p=0 asset.mp4
+sips -g pixelWidth -g pixelHeight asset.png
+identify asset.webp
+```
+
+Use the measured width and height to preserve aspect ratio. For a 1080x1920 vertical ad, a common centered fit is:
+
+```text
+scaledWidth = min(assetWidth * scale, 900)
+scaledHeight = scaledWidth / (assetWidth / assetHeight)
+x = (1080 - scaledWidth) / 2
+y = chosen safe-area top offset
+```
+
+Do not guess asset size. Tiny logos, wide screenshots, and tall app screenshots need different scale and placement.
 
 ### Output Declaration
 
@@ -233,7 +258,7 @@ 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)
+[-] = video xai.imagine("Cinematic product shot, premium lighting, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", aspect_ratio: "9:16", duration: 5)
 [-] = audio xai.tts("Welcome to SceneRok", voice: "eve")
 
 # ElevenLabs music package functions require an import alias.
@@ -272,6 +297,10 @@ import motion from "@scenerok/basic-animations"
 
 [-] = video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
 
+# Static asset with measured 4:3-ish aspect ratio, centered in a vertical 1080x1920 frame.
+[0s .. 3.4s] = video app_screen, width: 760, height: 615, x: 160, y: 300, animate: [motion.riseIn(0.6s, 70), motion.float(2.4s, 8)]
+[3.4s .. 4s] = video app_screen, width: 760, height: 615, x: 160, y: 300, animate: motion.fadeOut(0.6s)
+
 [0s .. 2s] = text "Title", animate: {
   type: "fade",
   from: { opacity: 0 },

package/skills/{claude → shared}/vidscript-sample.md

@@ -15,7 +15,7 @@ input cta_text = "{{cta_text | visit your nearest grocery store}}"
 [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",
+    "Premium lifestyle product shot of " + product_name + " chocolate milk in 250ml carton, cinematic lighting, 9:16 vertical, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy",
     aspect_ratio: "9:16",
     duration: 6
 )

package/skills/{codex → shared}/vidscript-strict.md

@@ -14,20 +14,65 @@ Without the owning import, calls like `xai.imagine`, `xai.tts`, `eleven.music`,
 
 **Never** call package functions without importing the package alias first.
 
-## Rule 2: Use registered plugin surfaces
+## Rule 2: Prefer real URL assets before generative media
+
+When the user gives a product, company, ecommerce, landing page, or app URL and you have browser/screenshot capability, visit the page and capture useful screenshots first. Save hero sections, product views, app screenshots, pricing/offer sections, testimonials, and detectable logos or brand marks as local image assets. Use those assets in VidScript `input` declarations and compose the ad around real product visuals.
+
+Only use `xai.imagine` or other fully generative visuals when site assets are unavailable, too low quality, needed as background/transition material, or explicitly requested by the user. Do not invent claims; use website copy or ask the user.
+
+## Rule 2.5: Probe real asset dimensions before placement
+
+Before writing `width`, `height`, `x`, or `y` for a real image/video/screenshot/logo, inspect the actual asset dimensions and duration:
+
+```bash
+ffprobe -v error -select_streams v:0 -show_entries stream=width,height,duration -of csv=p=0 asset.mp4
+sips -g pixelWidth -g pixelHeight asset.png
+identify asset.webp
+```
+
+Use measured aspect ratio and safe-area math. Do not guess sizes or blindly resize every asset to the same box. Center visuals with explicit pixel placement when possible:
+
+```text
+x = (outputWidth - scaledWidth) / 2
+y = safeAreaTop
+```
+
+Add entry motion to real assets, not only text. When a static visual needs a clean exit, split it:
+
+```vidscript
+import motion from "@scenerok/basic-animations"
+
+[0s .. 3.4s] = video product, width: 760, height: 615, x: 160, y: 300, animate: [motion.riseIn(0.6s, 70), motion.float(2.4s, 8)]
+[3.4s .. 4s] = video product, width: 760, height: 615, x: 160, y: 300, animate: motion.fadeOut(0.6s)
+```
+
+## Rule 3: Generated media prompts must forbid text
+
+AI-generated images and videos must not contain readable text. In every prompt for generated visual media, explicitly ask for no text, no words, no letters, no captions, no logos, no watermarks, and no readable UI copy. SceneRok has strong text primitives; all final titles, subtitles, offers, prices, feature labels, disclaimers, and CTAs must be added with VidScript `text` instructions instead of being baked into generated media.
+
+Good prompt pattern:
+
+```vidscript
+[-] = video xai.imagine("Clean cinematic product background, premium lighting, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", aspect_ratio: "9:16", duration: 5)
+[0.5s .. 3s] = text "Launch offer", style: title, color: "#FFFFFF", x: "50%", y: "30%", stroke: "#000000", stroke_width: 3
+```
+
+Invalid: asking the generator for signs, labels, packaging text, app UI text, title cards, lower thirds, prices, CTA buttons, or any readable copy.
+
+## Rule 4: 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)
+[-] = video xai.imagine("Prompt here, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", 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 `..`
+## Rule 5: Time ranges use `..`
 
 ```vidscript
 [0s .. 5s] = text "Hello"
@@ -35,17 +80,17 @@ For ElevenLabs music, import `@elevenlabs/music` and use `eleven.music(...)`, `e
 
 Not `[0s - 5s]`.
 
-## Rule 4: Text params stay on one line
+## Rule 6: 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
+## Rule 7: 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
+## Rule 8: Audio syntax
 
 ```vidscript
 import xai from "@scenerok/xai"
@@ -65,7 +110,7 @@ let bed = eleven.music("Soft premium ad music", duration: 15, instrumental: true
 
 **Invalid:** `eleven.generateMusic(...)` without `import eleven from "@elevenlabs/music"`.
 
-## Rule 7: Filters
+## Rule 9: Filters
 
 ```vidscript
 [0s .. 15s] = filter "vignette", intensity: 0.3
@@ -74,7 +119,7 @@ let bed = eleven.music("Soft premium ad music", duration: 15, instrumental: true
 
 `saturation` uses `value`, not `intensity`.
 
-## Rule 8: Always end with output
+## Rule 10: Always end with output
 
 ```vidscript
 output to "video.mp4", resolution: "1080x1920", fps: 30