@scenerok/cli 2.2.0 → 2.3.0

package/skills/{remote → scenerok/references}/workflow.md

@@ -3,7 +3,7 @@
 ## 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`)
+2. **Choose authoring** — VidScript (`.vid`) by default and for every editing action; TypeScript `@scenerok/sdk` (`.ts`, `sdk-guide.md`) only for loops or computed timing
 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
@@ -13,7 +13,8 @@
 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
+12. **Check the render** — `scenerok lint-video <render-id> --cost medium --json` (billed); fix and re-render if it reports problems. `scenerok render script.vid --validate` does render and check in one step
+13. **Deliver** — share download URL when complete
 
 ## Website URL asset workflow
 
@@ -50,11 +51,9 @@ 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
+scenerok skills install <platform>   # installs the skill (SKILL.md + references)
+scenerok skills check [--json]       # is the installed copy current?
+scenerok skills update               # refresh it from scenerok.com
 ```
 
 ## Error handling

package/skills/remote/vidscript-sample.md

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

package/skills/shared/SKILL.md

@@ -1,157 +0,0 @@
----
-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