@scenerok/cli 1.0.7 → 1.0.8

package/skills/codex/vidscript-guide.md

@@ -152,7 +152,7 @@ hero.Speed(factor: 1.5)
 | `x` | number \| string | Horizontal position. Number = px from left. `"50%"` = percent of width. Overrides `position`. |
 | `y` | number \| string | Vertical position. Number = px from top. `"50%"` = percent of height. Overrides `position`. |
 | `color` | string | Hex color |
-| `size` | number | Font size in pixels |
+| `size` | number \| string | Font size in output canvas pixels. `size: 72` is shorthand for `size: "72px"`. |
 | `font` | string | Font family. System fonts or Google Fonts: `"Inter"`, `"Bebas Neue"`, `"Space Grotesk"`, `"Outfit"`, etc. |
 | `align` | string | `left`, `center`, `right`. Default: `center` |
 | `line_height` | number | Line height multiplier for multi-line text. Default: 1.2 |
@@ -254,68 +254,73 @@ let bed = eleven.music("Warm premium launch bed", duration: 15, instrumental: tr
 [0s .. 15s] = audio eleven.music("..."), volume: 0.5      # trailing params after direct plugin call
 ```
 
-## Animations, Effects & Plugins (v2 Extensibility)
+## Animations, Effects & Rendering (v2)
 
-VidScript v2 uses a **minimal-grammar, plugin-first** architecture for animations and effects.
+VidScript v2 uses a **minimal-grammar, plugin-first** architecture. The compiler lowers VidScript into `IRTimeline` — the single contract shared by browser preview and final render.
 
-Instead of adding dozens of animation keywords to the language, we use two powerful parameters:
+User-facing extension uses two parameters on any text or video surface:
 
-- `animate:`
-- `effects:`
-
-These accept either plugin function calls or plain object descriptors.
+- `animate:` — motion over time (plugin calls or object descriptors)
+- `effects:` — post-processing filters with optional animated params
 
 ### animate: parameter
 
-Attach animations to **any** text or video surface.
-
 ```vidscript
 import motion from "@scenerok/basic-animations"
 
-text "Hello", animate: motion.fadeIn(0.8s)
+[0s .. 3s] = text "Hello", x: "50%", y: "50%", animate: motion.fadeIn(0.8s)
 
-video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
+[-] = video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
 
-text "Title", animate: {
+[0s .. 2s] = text "Title", animate: {
   type: "fade",
   from: { opacity: 0 },
   to: { opacity: 1 },
   start: 0,
-  end: 1.5
+  end: 1.5,
+  easing: "easeOutQuad"
 }
 ```
 
-### effects: parameter
+Compiler lowers `animate:` into `IRMotionTrack[]` (property-path keyframes). Legacy `IRAnimation` descriptors are adapted at runtime for backward compatibility.
 
-Attach post-processing effects, with support for animated parameters.
+### effects: parameter
 
 ```vidscript
-text "Dramatic", effects: [grayscale(intensity: 0.8)]
+[0s .. 5s] = filter "vignette", intensity: 0.4
 
-video hero, effects: [{
-  name: "glitch",
-  strength: animate: { type: "fade", from: { strength: 0 }, to: { strength: 1 } }
-}]
+[0s .. 5s] = filter "glitch", intensity: 0.5, animate: motion.fadeIn(1s)
 ```
 
-### Currently Available Animation Functions (`basic-animations` plugin)
-
-| Function                  | Description                  |
-|---------------------------|------------------------------|
-| `motion.fadeIn(duration?)`       | Opacity 0 → 1                |
-| `motion.fadeOut(duration?)`      | Opacity 1 → 0                |
-| `motion.slideX(from, to, dur?)`  | Horizontal slide             |
-| `motion.slideY(from, to, dur?)`  | Vertical slide               |
-| `motion.popIn(duration?)`        | Scale + fade entrance        |
-| `motion.riseIn(duration?, dist?)` | Upward fade entrance         |
-| `motion.swingIn(duration?)`      | Rotating slide/fade         |
-| `motion.glitchIn(duration?)`     | Jitter + flash entrance      |
-| `motion.float(duration?, amp?)`   | Gentle vertical bob          |
-| `motion.typewriter(duration?)`   | Character reveal             |
-
-More plugins (advanced text animations, pixel effects, 3D, etc.) are planned.
+Built-in filters: `monochrome`, `sepia`, `blur`, `chromatic`, `glitch`, `vignette`, `contrast`, `saturation`, `brightness`.
 
-The full architecture and IR details live in `plan-v1/29-surface-animation-effect-plugin-architecture.md`.
+### Animation functions (`@scenerok/basic-animations`)
+
+| Function | Description |
+|----------|-------------|
+| `motion.fadeIn(duration?)` | Opacity 0 → 1 |
+| `motion.fadeOut(duration?)` | Opacity 1 → 0 |
+| `motion.slideX(from, to, dur?)` | Horizontal slide |
+| `motion.slideY(from, to, dur?)` | Vertical slide |
+| `motion.popIn(duration?)` | Scale + fade entrance |
+| `motion.riseIn(duration?, dist?)` | Upward fade entrance |
+| `motion.swingIn(duration?)` | Rotating slide/fade |
+| `motion.glitchIn(duration?)` | Jitter + flash entrance |
+| `motion.float(duration?, amp?)` | Gentle vertical bob |
+| `motion.typewriter(duration?)` | Character reveal |
+
+### Render architecture (contributors)
+
+Implemented registry-based rendering. See `plan-v1/35-render-subsystem-architecture.md`.
+
+| Registry | Path | Add via |
+|----------|------|---------|
+| Motion | `src/lib/motion/registry.ts` | `registerEasing`, `registerMotionBehavior` |
+| Surface | `src/render/surfaces/registry.ts` | `registerSurfaceRenderer` |
+| Effect | `src/render/effects/registry.ts` | `registerEffect` or `src/shaders/library.ts` |
+| Engine | `src/render/engine/index.ts` | `createRenderEngine` backends |
+
+For SceneRok platform engineering, load the **`scenerok-development`** skill (`.agents/skills/scenerok-development/`).
 
 ## Expressions
 

package/skills/cursor/SKILL.md

@@ -1,8 +1,17 @@
-# SceneRok Skill for Claude Code
+---
+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 Claude Code. 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 Cursor. You help users create video content using the SceneRok platform directly from their terminal.
 
 ## Capabilities
 
@@ -171,6 +180,15 @@ Always ask clarifying questions about:
 | `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/cursor/vidscript-guide.md

@@ -152,7 +152,7 @@ hero.Speed(factor: 1.5)
 | `x` | number \| string | Horizontal position. Number = px from left. `"50%"` = percent of width. Overrides `position`. |
 | `y` | number \| string | Vertical position. Number = px from top. `"50%"` = percent of height. Overrides `position`. |
 | `color` | string | Hex color |
-| `size` | number | Font size in pixels |
+| `size` | number \| string | Font size in output canvas pixels. `size: 72` is shorthand for `size: "72px"`. |
 | `font` | string | Font family. System fonts or Google Fonts: `"Inter"`, `"Bebas Neue"`, `"Space Grotesk"`, `"Outfit"`, etc. |
 | `align` | string | `left`, `center`, `right`. Default: `center` |
 | `line_height` | number | Line height multiplier for multi-line text. Default: 1.2 |
@@ -254,68 +254,73 @@ let bed = eleven.music("Warm premium launch bed", duration: 15, instrumental: tr
 [0s .. 15s] = audio eleven.music("..."), volume: 0.5      # trailing params after direct plugin call
 ```
 
-## Animations, Effects & Plugins (v2 Extensibility)
+## Animations, Effects & Rendering (v2)
 
-VidScript v2 uses a **minimal-grammar, plugin-first** architecture for animations and effects.
+VidScript v2 uses a **minimal-grammar, plugin-first** architecture. The compiler lowers VidScript into `IRTimeline` — the single contract shared by browser preview and final render.
 
-Instead of adding dozens of animation keywords to the language, we use two powerful parameters:
+User-facing extension uses two parameters on any text or video surface:
 
-- `animate:`
-- `effects:`
-
-These accept either plugin function calls or plain object descriptors.
+- `animate:` — motion over time (plugin calls or object descriptors)
+- `effects:` — post-processing filters with optional animated params
 
 ### animate: parameter
 
-Attach animations to **any** text or video surface.
-
 ```vidscript
 import motion from "@scenerok/basic-animations"
 
-text "Hello", animate: motion.fadeIn(0.8s)
+[0s .. 3s] = text "Hello", x: "50%", y: "50%", animate: motion.fadeIn(0.8s)
 
-video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
+[-] = video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
 
-text "Title", animate: {
+[0s .. 2s] = text "Title", animate: {
   type: "fade",
   from: { opacity: 0 },
   to: { opacity: 1 },
   start: 0,
-  end: 1.5
+  end: 1.5,
+  easing: "easeOutQuad"
 }
 ```
 
-### effects: parameter
+Compiler lowers `animate:` into `IRMotionTrack[]` (property-path keyframes). Legacy `IRAnimation` descriptors are adapted at runtime for backward compatibility.
 
-Attach post-processing effects, with support for animated parameters.
+### effects: parameter
 
 ```vidscript
-text "Dramatic", effects: [grayscale(intensity: 0.8)]
+[0s .. 5s] = filter "vignette", intensity: 0.4
 
-video hero, effects: [{
-  name: "glitch",
-  strength: animate: { type: "fade", from: { strength: 0 }, to: { strength: 1 } }
-}]
+[0s .. 5s] = filter "glitch", intensity: 0.5, animate: motion.fadeIn(1s)
 ```
 
-### Currently Available Animation Functions (`basic-animations` plugin)
-
-| Function                  | Description                  |
-|---------------------------|------------------------------|
-| `motion.fadeIn(duration?)`       | Opacity 0 → 1                |
-| `motion.fadeOut(duration?)`      | Opacity 1 → 0                |
-| `motion.slideX(from, to, dur?)`  | Horizontal slide             |
-| `motion.slideY(from, to, dur?)`  | Vertical slide               |
-| `motion.popIn(duration?)`        | Scale + fade entrance        |
-| `motion.riseIn(duration?, dist?)` | Upward fade entrance         |
-| `motion.swingIn(duration?)`      | Rotating slide/fade         |
-| `motion.glitchIn(duration?)`     | Jitter + flash entrance      |
-| `motion.float(duration?, amp?)`   | Gentle vertical bob          |
-| `motion.typewriter(duration?)`   | Character reveal             |
-
-More plugins (advanced text animations, pixel effects, 3D, etc.) are planned.
+Built-in filters: `monochrome`, `sepia`, `blur`, `chromatic`, `glitch`, `vignette`, `contrast`, `saturation`, `brightness`.
 
-The full architecture and IR details live in `plan-v1/29-surface-animation-effect-plugin-architecture.md`.
+### Animation functions (`@scenerok/basic-animations`)
+
+| Function | Description |
+|----------|-------------|
+| `motion.fadeIn(duration?)` | Opacity 0 → 1 |
+| `motion.fadeOut(duration?)` | Opacity 1 → 0 |
+| `motion.slideX(from, to, dur?)` | Horizontal slide |
+| `motion.slideY(from, to, dur?)` | Vertical slide |
+| `motion.popIn(duration?)` | Scale + fade entrance |
+| `motion.riseIn(duration?, dist?)` | Upward fade entrance |
+| `motion.swingIn(duration?)` | Rotating slide/fade |
+| `motion.glitchIn(duration?)` | Jitter + flash entrance |
+| `motion.float(duration?, amp?)` | Gentle vertical bob |
+| `motion.typewriter(duration?)` | Character reveal |
+
+### Render architecture (contributors)
+
+Implemented registry-based rendering. See `plan-v1/35-render-subsystem-architecture.md`.
+
+| Registry | Path | Add via |
+|----------|------|---------|
+| Motion | `src/lib/motion/registry.ts` | `registerEasing`, `registerMotionBehavior` |
+| Surface | `src/render/surfaces/registry.ts` | `registerSurfaceRenderer` |
+| Effect | `src/render/effects/registry.ts` | `registerEffect` or `src/shaders/library.ts` |
+| Engine | `src/render/engine/index.ts` | `createRenderEngine` backends |
+
+For SceneRok platform engineering, load the **`scenerok-development`** skill (`.agents/skills/scenerok-development/`).
 
 ## Expressions
 

package/skills/opencode/SKILL.md

@@ -1,8 +1,17 @@
-# SceneRok Skill for Claude Code
+---
+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 OpenCode
 
 ## 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.
+You are a VidScript composer and video generation expert integrated with OpenCode. You help users create video content using the SceneRok platform directly from their terminal.
 
 ## Capabilities
 
@@ -171,6 +180,15 @@ Always ask clarifying questions about:
 | `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/opencode/vidscript-guide.md

@@ -152,7 +152,7 @@ hero.Speed(factor: 1.5)
 | `x` | number \| string | Horizontal position. Number = px from left. `"50%"` = percent of width. Overrides `position`. |
 | `y` | number \| string | Vertical position. Number = px from top. `"50%"` = percent of height. Overrides `position`. |
 | `color` | string | Hex color |
-| `size` | number | Font size in pixels |
+| `size` | number \| string | Font size in output canvas pixels. `size: 72` is shorthand for `size: "72px"`. |
 | `font` | string | Font family. System fonts or Google Fonts: `"Inter"`, `"Bebas Neue"`, `"Space Grotesk"`, `"Outfit"`, etc. |
 | `align` | string | `left`, `center`, `right`. Default: `center` |
 | `line_height` | number | Line height multiplier for multi-line text. Default: 1.2 |
@@ -254,68 +254,73 @@ let bed = eleven.music("Warm premium launch bed", duration: 15, instrumental: tr
 [0s .. 15s] = audio eleven.music("..."), volume: 0.5      # trailing params after direct plugin call
 ```
 
-## Animations, Effects & Plugins (v2 Extensibility)
+## Animations, Effects & Rendering (v2)
 
-VidScript v2 uses a **minimal-grammar, plugin-first** architecture for animations and effects.
+VidScript v2 uses a **minimal-grammar, plugin-first** architecture. The compiler lowers VidScript into `IRTimeline` — the single contract shared by browser preview and final render.
 
-Instead of adding dozens of animation keywords to the language, we use two powerful parameters:
+User-facing extension uses two parameters on any text or video surface:
 
-- `animate:`
-- `effects:`
-
-These accept either plugin function calls or plain object descriptors.
+- `animate:` — motion over time (plugin calls or object descriptors)
+- `effects:` — post-processing filters with optional animated params
 
 ### animate: parameter
 
-Attach animations to **any** text or video surface.
-
 ```vidscript
 import motion from "@scenerok/basic-animations"
 
-text "Hello", animate: motion.fadeIn(0.8s)
+[0s .. 3s] = text "Hello", x: "50%", y: "50%", animate: motion.fadeIn(0.8s)
 
-video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
+[-] = video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
 
-text "Title", animate: {
+[0s .. 2s] = text "Title", animate: {
   type: "fade",
   from: { opacity: 0 },
   to: { opacity: 1 },
   start: 0,
-  end: 1.5
+  end: 1.5,
+  easing: "easeOutQuad"
 }
 ```
 
-### effects: parameter
+Compiler lowers `animate:` into `IRMotionTrack[]` (property-path keyframes). Legacy `IRAnimation` descriptors are adapted at runtime for backward compatibility.
 
-Attach post-processing effects, with support for animated parameters.
+### effects: parameter
 
 ```vidscript
-text "Dramatic", effects: [grayscale(intensity: 0.8)]
+[0s .. 5s] = filter "vignette", intensity: 0.4
 
-video hero, effects: [{
-  name: "glitch",
-  strength: animate: { type: "fade", from: { strength: 0 }, to: { strength: 1 } }
-}]
+[0s .. 5s] = filter "glitch", intensity: 0.5, animate: motion.fadeIn(1s)
 ```
 
-### Currently Available Animation Functions (`basic-animations` plugin)
-
-| Function                  | Description                  |
-|---------------------------|------------------------------|
-| `motion.fadeIn(duration?)`       | Opacity 0 → 1                |
-| `motion.fadeOut(duration?)`      | Opacity 1 → 0                |
-| `motion.slideX(from, to, dur?)`  | Horizontal slide             |
-| `motion.slideY(from, to, dur?)`  | Vertical slide               |
-| `motion.popIn(duration?)`        | Scale + fade entrance        |
-| `motion.riseIn(duration?, dist?)` | Upward fade entrance         |
-| `motion.swingIn(duration?)`      | Rotating slide/fade         |
-| `motion.glitchIn(duration?)`     | Jitter + flash entrance      |
-| `motion.float(duration?, amp?)`   | Gentle vertical bob          |
-| `motion.typewriter(duration?)`   | Character reveal             |
-
-More plugins (advanced text animations, pixel effects, 3D, etc.) are planned.
+Built-in filters: `monochrome`, `sepia`, `blur`, `chromatic`, `glitch`, `vignette`, `contrast`, `saturation`, `brightness`.
 
-The full architecture and IR details live in `plan-v1/29-surface-animation-effect-plugin-architecture.md`.
+### Animation functions (`@scenerok/basic-animations`)
+
+| Function | Description |
+|----------|-------------|
+| `motion.fadeIn(duration?)` | Opacity 0 → 1 |
+| `motion.fadeOut(duration?)` | Opacity 1 → 0 |
+| `motion.slideX(from, to, dur?)` | Horizontal slide |
+| `motion.slideY(from, to, dur?)` | Vertical slide |
+| `motion.popIn(duration?)` | Scale + fade entrance |
+| `motion.riseIn(duration?, dist?)` | Upward fade entrance |
+| `motion.swingIn(duration?)` | Rotating slide/fade |
+| `motion.glitchIn(duration?)` | Jitter + flash entrance |
+| `motion.float(duration?, amp?)` | Gentle vertical bob |
+| `motion.typewriter(duration?)` | Character reveal |
+
+### Render architecture (contributors)
+
+Implemented registry-based rendering. See `plan-v1/35-render-subsystem-architecture.md`.
+
+| Registry | Path | Add via |
+|----------|------|---------|
+| Motion | `src/lib/motion/registry.ts` | `registerEasing`, `registerMotionBehavior` |
+| Surface | `src/render/surfaces/registry.ts` | `registerSurfaceRenderer` |
+| Effect | `src/render/effects/registry.ts` | `registerEffect` or `src/shaders/library.ts` |
+| Engine | `src/render/engine/index.ts` | `createRenderEngine` backends |
+
+For SceneRok platform engineering, load the **`scenerok-development`** skill (`.agents/skills/scenerok-development/`).
 
 ## Expressions
 

package/skills/skills/aider/SKILL.md

@@ -180,6 +180,15 @@ Always ask clarifying questions about:
 | `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/skills/aider/vidscript-guide.md

@@ -152,7 +152,7 @@ hero.Speed(factor: 1.5)
 | `x` | number \| string | Horizontal position. Number = px from left. `"50%"` = percent of width. Overrides `position`. |
 | `y` | number \| string | Vertical position. Number = px from top. `"50%"` = percent of height. Overrides `position`. |
 | `color` | string | Hex color |
-| `size` | number | Font size in pixels |
+| `size` | number \| string | Font size in output canvas pixels. `size: 72` is shorthand for `size: "72px"`. |
 | `font` | string | Font family. System fonts or Google Fonts: `"Inter"`, `"Bebas Neue"`, `"Space Grotesk"`, `"Outfit"`, etc. |
 | `align` | string | `left`, `center`, `right`. Default: `center` |
 | `line_height` | number | Line height multiplier for multi-line text. Default: 1.2 |
@@ -254,68 +254,73 @@ let bed = eleven.music("Warm premium launch bed", duration: 15, instrumental: tr
 [0s .. 15s] = audio eleven.music("..."), volume: 0.5      # trailing params after direct plugin call
 ```
 
-## Animations, Effects & Plugins (v2 Extensibility)
+## Animations, Effects & Rendering (v2)
 
-VidScript v2 uses a **minimal-grammar, plugin-first** architecture for animations and effects.
+VidScript v2 uses a **minimal-grammar, plugin-first** architecture. The compiler lowers VidScript into `IRTimeline` — the single contract shared by browser preview and final render.
 
-Instead of adding dozens of animation keywords to the language, we use two powerful parameters:
+User-facing extension uses two parameters on any text or video surface:
 
-- `animate:`
-- `effects:`
-
-These accept either plugin function calls or plain object descriptors.
+- `animate:` — motion over time (plugin calls or object descriptors)
+- `effects:` — post-processing filters with optional animated params
 
 ### animate: parameter
 
-Attach animations to **any** text or video surface.
-
 ```vidscript
 import motion from "@scenerok/basic-animations"
 
-text "Hello", animate: motion.fadeIn(0.8s)
+[0s .. 3s] = text "Hello", x: "50%", y: "50%", animate: motion.fadeIn(0.8s)
 
-video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
+[-] = video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
 
-text "Title", animate: {
+[0s .. 2s] = text "Title", animate: {
   type: "fade",
   from: { opacity: 0 },
   to: { opacity: 1 },
   start: 0,
-  end: 1.5
+  end: 1.5,
+  easing: "easeOutQuad"
 }
 ```
 
-### effects: parameter
+Compiler lowers `animate:` into `IRMotionTrack[]` (property-path keyframes). Legacy `IRAnimation` descriptors are adapted at runtime for backward compatibility.
 
-Attach post-processing effects, with support for animated parameters.
+### effects: parameter
 
 ```vidscript
-text "Dramatic", effects: [grayscale(intensity: 0.8)]
+[0s .. 5s] = filter "vignette", intensity: 0.4
 
-video hero, effects: [{
-  name: "glitch",
-  strength: animate: { type: "fade", from: { strength: 0 }, to: { strength: 1 } }
-}]
+[0s .. 5s] = filter "glitch", intensity: 0.5, animate: motion.fadeIn(1s)
 ```
 
-### Currently Available Animation Functions (`basic-animations` plugin)
-
-| Function                  | Description                  |
-|---------------------------|------------------------------|
-| `motion.fadeIn(duration?)`       | Opacity 0 → 1                |
-| `motion.fadeOut(duration?)`      | Opacity 1 → 0                |
-| `motion.slideX(from, to, dur?)`  | Horizontal slide             |
-| `motion.slideY(from, to, dur?)`  | Vertical slide               |
-| `motion.popIn(duration?)`        | Scale + fade entrance        |
-| `motion.riseIn(duration?, dist?)` | Upward fade entrance         |
-| `motion.swingIn(duration?)`      | Rotating slide/fade         |
-| `motion.glitchIn(duration?)`     | Jitter + flash entrance      |
-| `motion.float(duration?, amp?)`   | Gentle vertical bob          |
-| `motion.typewriter(duration?)`   | Character reveal             |
-
-More plugins (advanced text animations, pixel effects, 3D, etc.) are planned.
+Built-in filters: `monochrome`, `sepia`, `blur`, `chromatic`, `glitch`, `vignette`, `contrast`, `saturation`, `brightness`.
 
-The full architecture and IR details live in `plan-v1/29-surface-animation-effect-plugin-architecture.md`.
+### Animation functions (`@scenerok/basic-animations`)
+
+| Function | Description |
+|----------|-------------|
+| `motion.fadeIn(duration?)` | Opacity 0 → 1 |
+| `motion.fadeOut(duration?)` | Opacity 1 → 0 |
+| `motion.slideX(from, to, dur?)` | Horizontal slide |
+| `motion.slideY(from, to, dur?)` | Vertical slide |
+| `motion.popIn(duration?)` | Scale + fade entrance |
+| `motion.riseIn(duration?, dist?)` | Upward fade entrance |
+| `motion.swingIn(duration?)` | Rotating slide/fade |
+| `motion.glitchIn(duration?)` | Jitter + flash entrance |
+| `motion.float(duration?, amp?)` | Gentle vertical bob |
+| `motion.typewriter(duration?)` | Character reveal |
+
+### Render architecture (contributors)
+
+Implemented registry-based rendering. See `plan-v1/35-render-subsystem-architecture.md`.
+
+| Registry | Path | Add via |
+|----------|------|---------|
+| Motion | `src/lib/motion/registry.ts` | `registerEasing`, `registerMotionBehavior` |
+| Surface | `src/render/surfaces/registry.ts` | `registerSurfaceRenderer` |
+| Effect | `src/render/effects/registry.ts` | `registerEffect` or `src/shaders/library.ts` |
+| Engine | `src/render/engine/index.ts` | `createRenderEngine` backends |
+
+For SceneRok platform engineering, load the **`scenerok-development`** skill (`.agents/skills/scenerok-development/`).
 
 ## Expressions
 

package/skills/skills/claude/SKILL.md

@@ -180,6 +180,15 @@ Always ask clarifying questions about:
 | `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