@scenerok/cli 2.2.0

package/skills/remote/vidscript-strict.md

@@ -0,0 +1,251 @@
+# VidScript v2 — Strict Agent Reference
+
+Follow these rules exactly. When in doubt, fetch `vidscript-sample.md` from https://scenerok.com/.well-known/agent-skills/ or run `scenerok skills sync` for local copies.
+
+## Rule 1: Package imports are mandatory
+
+```vidscript
+import xai from "@scenerok/xai"
+import cf from "@scenerok/cloudflare"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
+```
+
+Without the owning import, calls like `xai.imagine`, `cf.video`, `xai.tts`, `eleven.music`, and `motion.fadeIn` fail validation.
+
+**Never** call package functions without importing the package alias first.
+
+## Rule 2: Use URL assets selectively
+
+When the user gives a product, company, ecommerce, landing page, or app URL and you have browser/screenshot capability, you can visit the page and capture useful visual evidence. Favor above-fold screenshots, product views, app screenshots, pricing/offer cards, testimonials, and detectable logos or brand marks.
+
+Do not use full-page or very long website screenshots as video backgrounds; their text is usually illegible at output size. Crop or frame screenshots to the specific visual proof point, and use them sparingly.
+
+Website screenshots are optional source material, not a requirement to build the whole video from screenshots. You may combine them with still generation, text-to-video, image-to-video, reference-to-video, or extension plugins for lifestyle scenes, motion backgrounds, transitions, or product context. Do not invent claims; use website copy or ask the user.
+
+## Rule 2.5: Probe real asset type and dimensions before placement
+
+Before writing `width`, `height`, `x`, or `y` for a real image/video/screenshot/logo, identify the asset type and inspect the actual dimensions and duration:
+
+```bash
+file asset.png
+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 real video files for motion footage and still image inputs for screenshots, logos, product photos, and brand marks. The `video` primitive accepts both videos and images; image inputs render as static clips for the block duration.
+
+```vidscript
+input screenshot = "assets/screenshots/homepage.png"
+[0s .. 4s] = video screenshot, width: 1080, height: 1920, x: 0, y: 0, animate: motion.fadeIn(0.35s)
+```
+
+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 cf from "@scenerok/cloudflare"
+import eleven from "@elevenlabs/music"
+
+[- 4s] = video xai.image("Prompt here, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", aspect_ratio: "9:16", resolution: "2k")
+[-] = 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)
+[-] = video xai.imageToVideo("https://cdn.example.com/product.png", "Slow camera move around the product, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", aspect_ratio: "9:16", duration: 6)
+[-] = video xai.referenceToVideo(["https://cdn.example.com/product.png", "https://cdn.example.com/person.png"], "Lifestyle scene using the referenced product and person, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", aspect_ratio: "9:16", duration: 8)
+[-] = video xai.extendVideo("https://cdn.example.com/clip.mp4", "Continue the camera move, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", duration: 5)
+[-] = audio xai.tts("Voiceover line", voice: "eve")
+
+[-] = video cf.video("Prompt here, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", model: "pixverse/v6", aspect_ratio: "9:16", duration: 5, generate_audio: false)
+[-] = video cf.imageToVideo("https://cdn.example.com/product.png", "Animate the image, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", model: "runwayml/gen-4.5", aspect_ratio: "9:16", duration: 5)
+[0s .. 15s] = audio eleven.music("Warm premium music bed", duration: 15, instrumental: true)
+```
+
+Do not overuse one plugin function. Choose deliberately:
+
+| Need | Use |
+|------|-----|
+| Still image clip | `xai.image`, `xai.generateImage`, `cf.image`, `cf.generateImage` |
+| Text-to-video | `xai.imagine`, `xai.genVideo`, `cf.video`, `cf.imagine`, `cf.generateVideo` |
+| Animate one image/screenshot/product photo | `xai.imageToVideo`, `cf.imageToVideo` |
+| Guide with 1-7 reference images | `xai.referenceToVideo`, `cf.referenceToVideo` |
+| Continue a clip | `xai.extendVideo`, `cf.extendVideo` |
+| Voiceover | `xai.tts`, `xai.textToSpeech` |
+| Music bed | `eleven.music`, `eleven.generateMusic`, `eleven.composeMusic` |
+
+Use `imageToVideo` for one extracted screenshot/product/logo image. Use `referenceToVideo` for 1-7 reference images when extracted objects should guide the generated shot. xAI `referenceToVideo` requires a prompt and duration must be <= 10s.
+
+For Cloudflare calls, always prefer explicit `model:` and use `aspect_ratio: "9:16"` for vertical, `"16:9"` for wide, `"1:1"` for square, or model-supported values such as `"4:3"`, `"3:4"`, and `"21:9"`. `cf.imageToVideo(image, prompt, model: ..., aspect_ratio: ..., duration: ...)` accepts `aspect_ratio`; for Runway Gen-4.5, SceneRok translates `"9:16"` to Cloudflare's required `ratio: "720:1280"`. Useful models include `pixverse/v6`, `vidu/q3-turbo`, `runwayml/gen-4.5`, `minimax/hailuo-2.3`, `bytedance/seedance-2.0`, `google/veo-3.1`, `google/veo-3.1-fast`, `google/veo-3-fast`, `black-forest-labs/flux-2-pro-preview`, and `openai/gpt-image-2`. Veo models accept `duration: 4`, `duration: 4s`, or `duration: "4s"` — all forms snap to the supported 4s/6s/8s durations.
+
+xAI TTS voices are only `eve`, `ara`, `rex`, `sal`, and `leo`.
+
+For ElevenLabs music, import `@elevenlabs/music` and use `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`. Do not call `eleven.tts(...)`; ElevenLabs TTS is not registered in VidScript today. Ads, promos, tutorials, and reels should normally include either `xai.tts` voiceover, an ElevenLabs music bed, or both unless the user asks for silent output.
+
+## Rule 4.5: `[-]` uses separate audio and visual playheads
+
+Use `[-]` freely for generated visual sequences even when audio is already scheduled. VidScript advances audio and visual auto blocks independently:
+
+```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+
+input family_image = "https://cdn.example.com/family.png"
+let bed = eleven.music("Warm family music", duration: 15, instrumental: true)
+[0s .. 15s] = audio bed, volume: 0.35, fade_out: 2s
+[-] = video xai.imageToVideo(family_image, "Warm family moment, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", aspect_ratio: "9:16", duration: 15)
+```
+
+The video starts at the visual playhead, usually `0s`; it is not pushed to `15s` by the audio bed. Audio blocks such as `[-] = audio xai.tts(...)` advance only the audio playhead. Visual blocks such as `[-] = video ...` and `[-] = text ...` advance only the visual playhead. A block containing both audio and visual instructions advances both.
+
+Use explicit ranges when you need exact synchronization, overlaps, or cuts. Do not avoid `[-]` solely because the script contains music or voiceover.
+
+## Rule 4.6: Never guess generated-asset durations
+
+Invalid — the real TTS length is unknown at write time, so a guessed window clips or overlaps:
+
+```vidscript
+[0s .. 3s] = audio xai.tts("A sentence that may well run past three seconds", voice: "eve")
+[3s .. 6s] = audio xai.tts("This one starts while the first is still playing", voice: "eve")
+```
+
+Valid — assign with `let` and reference the measured `duration` (arithmetic allowed), or use `[-]` auto blocks:
+
+```vidscript
+let vo1 = xai.tts("First line", voice: "eve")
+let vo2 = xai.tts("Second line", voice: "eve")
+[0 .. vo1.duration] = audio vo1
+[vo1.duration + 0.3 .. vo1.duration + 0.3 + vo2.duration] = audio vo2
+```
+
+Exported timelines expose `.duration` the same way: `[scene1.duration .. scene1.duration + 4] = ...`.
+
+## Rule 4.7: Prefer `area:` over hand-picked text coordinates
+
+Built-in named regions work with no setup and guarantee the text fits its cell (wrap + shrink + bounds):
+
+```vidscript
+[0 .. 3] = text "BIG SALE", area: "title"
+[0 .. 3] = text "50% off this week", area: "lower-third"
+```
+
+Available by default: `title`, `stage`, `lower-third`, `caption`. Custom layouts: `grid rows: "20% 1fr 30%", areas: ["title", "stage", "caption"]` (CSS Grid semantics, `%`/`fr` tracks only). Explicit `x`/`y` still work and override the area — use them only when a region genuinely doesn't fit the design.
+
+**TypeScript SDK:** same regions via `t.grid({ rows, cols?, areas })` and `text(..., { area: 'title' })` — see `sdk-guide.md`.
+
+## Rule 5: Time ranges use `..`
+
+```vidscript
+[0s .. 5s] = text "Hello"
+```
+
+Not `[0s - 5s]`.
+
+## 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 7: Quote safety in prompts
+
+Escape quote characters inside prompt strings, e.g. `xai.imagine("Package labeled \"RokMilk\", no text, no watermark")`.
+
+## Rule 8: Audio syntax
+
+```vidscript
+import xai from "@scenerok/xai"
+import cf from "@scenerok/cloudflare"
+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"`.
+
+**Invalid:** `eleven.tts(...)` — not a registered function; use `xai.tts(...)`.
+
+**Invalid:** `cf.video(...)` without `import cf from "@scenerok/cloudflare"`.
+
+## Rule 9: Filters
+
+```vidscript
+[0s .. 15s] = filter "vignette", intensity: 0.3
+[0s .. 15s] = filter "saturation", value: 1.12
+```
+
+Filters are optional finishing tools, not required ingredients. Use them only when they improve the visual result. `saturation` uses `value`, not `intensity`.
+
+## Rule 10: 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: `vidscript-guide.md` or https://scenerok.com/.well-known/agent-skills/vidscript-guide.md

package/skills/remote/workflow.md

@@ -0,0 +1,72 @@
+# SceneRok Compose Workflow
+
+## Pipeline
+
+1. **Understand the goal** — promo, testimonial, meme, code demo, etc.
+2. **Choose authoring** — short/human → VidScript (`.vid`); complex/agent → TypeScript `@scenerok/sdk` (`.ts`, see `sdk-guide.md`)
+3. **Plan the structure** — time blocks, durations, inputs
+4. **Gather assets** — URLs, local paths, generated clips, selective website screenshots
+5. **Probe asset type and dimensions** — `loadVideo` / media stdlib, or `file` / `ffprobe` / `sips` / `identify`; never guess
+6. **Use images directly when useful** — VidScript `video image_input`; SDK `video(path)` / `loadVideo`
+7. **Choose plugin modality** — still / t2v / i2v / ref2v / extend / TTS / music (`ai-models.md`, `tts.md`, `music.md`)
+8. **Compose** — measured dimensions, `area:` / `t.grid` for text, symbolic durations (`vo.duration` / returned node `.duration`), entry/exit beats
+9. **Validate** — `scenerok validate script.vid` or `scenerok validate scene.ts`
+10. **Deep-validate (VidScript)** — for scripts with TTS/generated media: `scenerok validate script.vid --generate-assets --report-json` (billed; assets cache for the render). SDK plugins generate during `scenerok render` instead. Fix `offCanvas`/`wasShrunk` text, `collisions`, and unintended `audio.overlaps`, then re-validate.
+11. **Render** — `scenerok render script.vid --watch` or `scenerok render scene.ts --watch`
+12. **Deliver** — share download URL when complete
+
+## Website URL asset workflow
+
+When the user provides a product, company, landing page, or ecommerce URL:
+
+1. Visit the URL with a browser tool before composing.
+2. Capture screenshots sparingly — above-fold, product closeups, pricing cards. Avoid full-page backgrounds.
+3. Crop to the visual evidence needed.
+4. Save product images, logos, app screenshots when accessible.
+5. Probe saved asset dimensions before composing.
+6. Use stills as timeline inputs or feed into `xai.imageToVideo` / `xai.referenceToVideo` (VidScript or SDK).
+7. Combine real assets with generated clips, text, and music.
+8. Scale from measured aspect ratio; keep primary visuals in ~80–88% frame width for 9:16.
+9. Animate assets: `motion.popIn` / SDK `popIn`, `fadeIn`, `slideY`.
+10. Generative prompts must require **no text, logos, watermarks, or readable UI** in AI output — add copy with `text`.
+11. Do not invent product claims — extract from site or ask the user.
+
+## Best practices
+
+- VidScript: `[-]` for channel-aware auto-append; SDK: `t.push(...)` / `t['-'] = ...`
+- Never guess TTS/music durations — bind the result and use `.duration`
+- Never guess text coordinates — VidScript `area: "title"`; SDK `t.grid(...)` + `text(..., { area: 'title' })`
+- Named arguments (VidScript): `hero.Trim(start: 0s, end: 5s)`
+- 1080×1920 vertical (TikTok/Instagram); 1920×1080 horizontal (YouTube)
+- Hook in first 3 seconds; high-contrast text with stroke when needed
+- Each render costs tokens (renders + AI plugins)
+
+## CLI commands
+
+```bash
+scenerok auth login
+scenerok validate script.vid
+scenerok validate scene.ts
+scenerok render script.vid --watch
+scenerok render scene.ts --watch
+scenerok status <render-id>
+scenerok skills install <platform>   # installs router skill
+scenerok skills sync                 # download full remote skill bundle
+scenerok skills check [--json]
+scenerok skills update
+scenerok secrets set KEY=VALUE
+```
+
+## Error handling
+
+If render fails: check `scenerok status <id>`, fix missing assets or syntax, re-render.
+
+## Sample video types
+
+- **Product promo** — hero + headline + CTA
+- **Social hook** — fast cuts, bold text
+- **Testimonial** — speaker clip + quote overlay
+- **Meme remix** — reaction clip + punchlines
+- **Title sequence** — background + glitch + typography
+
+For brand colors, logos, and accents see `brand-setup.md`. Ask the user only when your environment allows conversation and brand context is missing.

package/skills/shared/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: scenerok
+description: >-
+  Compose VidScript v2 or TypeScript @scenerok/sdk and render videos with SceneRok —
+  CLI, web editor, ChatGPT, or MCP. Use for promos, reels, motion graphics, code demos,
+  social cards, and any request mentioning VidScript, SceneRok, or scenerok.
+triggers:
+  - create a video
+  - make a reel
+  - generate a promo
+  - VidScript
+  - @scenerok/sdk
+  - scenerok render
+  - scenerok validate
+  - social video
+  - product launch video
+  - SceneRok editor
+---
+
+# SceneRok Agent Skill
+
+You help users compose **VidScript v2** or **TypeScript `@scenerok/sdk`** and produce MP4s with SceneRok. Skill content is **live at scenerok.com** — fetch it rather than relying on stale copies.
+
+## Dual authoring
+
+| Who / scene | Write |
+|-------------|--------|
+| Humans / short promos / templates | **VidScript** (`.vid`) |
+| Agents / complex, data-driven timelines | **TypeScript + `@scenerok/sdk`** (`.ts`) |
+
+Both emit the same `IRTimeline`. Load **`sdk-guide.md`** before writing SDK scenes.
+
+## 1. Know your environment
+
+Load **`environments.md`** and follow its capability matrix.
+
+| You are… | Do this |
+| --- | --- |
+| In the **SceneRok web editor** | Use `patch_vidscript`; validate/render in-app — VidScript today (SDK via CLI/MCP) |
+| On the **user's machine** with `scenerok` | `scenerok validate` → `scenerok render` (`.vid` or `.ts`) |
+| A **ChatGPT GPT** with SceneRok Actions | OAuth + `validateVidscript` → `renderVideo`; import uploads first |
+| **Gemini / Grok** without HTTP tools | Compose VidScript or SDK TS; user renders elsewhere |
+| **MCP host** with `scenerok-mcp` | Use MCP compose/render tools (`language: typescript` for SDK) |
+
+## 2. Load remote docs (required before composing)
+
+1. `https://scenerok.com/.well-known/agent-skills/index.json` — catalog
+2. **Always:** `vidscript-strict.md`, `intent-router.md`, `environments.md`
+3. **Complex / agent TS scenes:** also load `sdk-guide.md`
+4. **Media probe / frame grab / loadVideo:** `media-stdlib.md`
+5. **By intent** (see `intent-router.md`):
+
+| Intent | Load |
+| --- | --- |
+| Any VidScript composition | `vidscript-strict.md` |
+| Complex TS / loops / computed timing / grid in TS | `sdk-guide.md` |
+| AI generation (xAI / CF / ElevenLabs) — VidScript or TS | `ai-models.md` / `tts.md` / `music.md` (+ `sdk-guide.md` if TS) |
+| Workflow routing | `intent-router.md` |
+| HyperFrames / code / lower-thirds / social cards | `animations-picker.md` (+ `animations-catalog.md` if you need every param) |
+| Text animations (word reveals, scramble, kinetic type, gradient, quotes, stats, glitch, neon) | `animations-picker.md` text-anim rows (`animations.text_*`) |
+| Custom / bring-your-own animation — write HTML+CSS with GSAP, Three.js, or any seekable JS lib | `animations-catalog.md` → "Custom HTML" (`animations.custom_html`; author contract + template inside) |
+| Scene cuts / whip / dissolve | `transitions-catalog.md` |
+| Kinetic titles (motion primitives on `text`) | `text-styles.md` |
+| AI b-roll / product visuals | `ai-models.md` |
+| Voiceover | `tts.md` |
+| Music bed | `music.md` |
+| VFX on one clip | `shaders-filters.md` |
+| Full promo / URL assets | `workflow.md`, `brand-setup.md` |
+| Grammar deep-dive | `vidscript-guide.md` |
+| ChatGPT setup | `consumer-chat-apps.md`, `chatgpt-gpt-instructions.md` |
+
+Base: `https://scenerok.com/.well-known/agent-skills/{filename}`
+
+**Offline:** `scenerok skills sync` · **Freshness:** `scenerok skills check` · **Update:** `scenerok skills update`
+
+Browse previews: https://scenerok.com/catalog
+
+## 3. Compose pipeline (summary)
+
+1. Classify intent → `intent-router.md`
+2. Choose authoring: simple → VidScript; complex/agent → `@scenerok/sdk` (`sdk-guide.md`)
+3. Pick animation / transition / text / AI modality from the right catalog — **reuse-first**, do not invent syntax
+4. If branded promo and colors/logo unknown → `brand-setup.md` (one short question max)
+5. Probe asset dimensions before placement (`media-stdlib.md` / `loadVideo` / CLI `ffprobe`)
+6. `scenerok validate script.vid` or `scenerok validate scene.ts` (or editor / ChatGPT equivalent)
+7. Before rendering VidScript with TTS or generated media: `scenerok validate script.vid --generate-assets --report-json` — runs the real compile (billed, assets cached for the render), then read the inspection report: fix `offCanvas`/`wasShrunk` text, element `collisions`, and unintended `audio.overlaps` (voiceover-on-voiceover; music beds are fine). Patch and re-validate until clean. (SDK: plugins generate during `scenerok render`; `--generate-assets` is VidScript-only.)
+8. Render and deliver download URL
+9. After rendering, verify the actual MP4: `scenerok lint-video <render-id> --cost medium --json`. Fix reported issues and repeat: **write → validate → render → lint-video → fix**.
+
+**Never guess asset durations.** VidScript: `let vo = xai.tts(...)` + `vo.duration`. SDK: `await loadVideo(path)` / `await xai.tts(...)` and use `.duration` on the returned node.
+
+**Never guess text coordinates.** VidScript: `area: "title"` (+ optional `grid ...`). SDK: `t.grid({...})` then `text(..., { area: 'title' })`.
+
+## 4. Packages (import before use)
+
+| Surface | Packages |
+| --- | --- |
+| VidScript | `@scenerok/xai`, `@scenerok/cloudflare`, `@elevenlabs/music`, `@scenerok/media`, `@scenerok/basic-animations`, `@scenerok/animations`, `@scenerok/transitions` |
+| SDK core | `import { timeline, video, loadVideo, text, audio, s, fadeIn } from '@scenerok/sdk'` |
+| SDK AI | `import xai from '@scenerok/xai'` · `import cf from '@scenerok/cloudflare'` · `import eleven from '@elevenlabs/music'` |
+| SDK transitions | `import tr from '@scenerok/transitions'` — same catalog as VidScript (`tr.dissolve()`, `tr.push({ direction: 'right' })`, …) |
+| SDK stdlib | `import { getVideoLength, grabFrame, beats } from '@scenerok/stdlib'` (also re-exported from `@scenerok/sdk`) |
+
+## 5. CLI quick reference (desktop only)
+
+```bash
+scenerok auth login
+scenerok validate script.vid
+scenerok validate scene.ts
+scenerok validate script.vid --render --cost medium
+scenerok render script.vid --watch
+scenerok render scene.ts --watch
+scenerok lint-video 42 --cost low --json
+scenerok skills install cursor --sync
+```
+
+## 6. Minimal VidScript
+
+```vidscript
+import motion from "@scenerok/basic-animations"
+
+input hero = "https://cdn.example.com/clip.mp4"
+[-] = hero
+[- 3s] = text "Hello", style: title, color: "#FFF", area: "title", animate: motion.fadeIn(0.8s)
+output to "video.mp4", resolution: "1080x1920", fps: 30
+```
+
+## 7. Minimal SDK (TypeScript)
+
+```ts
+import { timeline, text, s, fadeIn } from '@scenerok/sdk'
+
+export default function main() {
+  const t = timeline({ width: 1080, height: 1920, fps: 30 })
+  t.grid({
+    rows: '16% 1fr 18% 10%',
+    areas: ['title', 'stage', 'lower-third', 'caption'],
+  })
+  t[0][s(3)] = text('SceneRok', { size: 72, area: 'title' }).animate(fadeIn(s(0.4)))
+  t[3][5] = text('Text to video', { size: 40, area: 'lower-third' })
+  return t.toIR()
+}
+```
+
+For AI generation, stdlib probing, and dual-index scheduling, load **`sdk-guide.md`**.
+
+## Platform engineering
+
+For parser/render/API work (not video composition), load **`scenerok-development`** from `.agents/skills/scenerok-development/` in the SceneRok repo.
+
+## Reference
+
+- Grammar: https://scenerok.com/.well-known/agent-skills/vidscript-guide.md
+- SDK: https://scenerok.com/.well-known/agent-skills/sdk-guide.md
+- Media stdlib: https://scenerok.com/.well-known/agent-skills/media-stdlib.md
+- Full docs: https://scenerok.com/llms-full.txt
+- Manifest: https://scenerok.com/.well-known/agent-skills/manifest.json