dsh-remotion 0.3.2 → 0.3.4

package/README.en.md

@@ -6,11 +6,11 @@
 
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 
-DSH (DeepSeek Harness) video-creation skill plugin: installing it registers the official Remotion skill into DSH (programmatic video with React: animation, audio, captions, 3D, charts, fonts; synced with the official Remotion v4.0.519 twelve-skill structure).
+DSH (DeepSeek Harness) video-creation skill plugin: installing it registers the official Remotion skill into DSH (programmatic video with React: animation, audio, captions, 3D, charts, fonts; synced with the official Remotion v4.0.529 twelve-skill structure).
 
 ## Compatibility
 
-Verified with official `@deepseek-ai/dsh@0.1.5-rc.1` and Node `24.16.0` on 2026-09-11: all 18 components load alongside Modlens, with passing tool-schema, skill-registration and offline read-only invocation checks. Uses the `cordis.patch.yml` + `dsh.bundle.patch` bundle model. Node requirements match this Harness release: 22.19 or later within 22.x, or 24 or later. Live external-service workflows require separate configuration and validation.
+Validation host: Harness `0.2.0-rc.1` built from official sources (commit `407e65c8`) with Node `24.16.0` on 2026-09-28. All 23 plugin tests pass in an isolated environment; all 18 plugins mount together in one host registering 12 skills and 1 tools, with tool schemas and health-check contracts passing. No live ports or external services were exercised in this round.
 
 ## Installation
 
@@ -31,7 +31,7 @@ Then restart the web service. To clean up fully, also remove the plugin entry fr
 
 ## Contents
 
-- **remotion-best-practices** (router hub) + 11 domain skills (captions/create/docs/interactivity/maps/markup/multimedia/render/saas/studio/upgrade), synced from official Remotion v4.0.519
+- **remotion-best-practices** (router hub) + 11 domain skills (captions/create/docs/interactivity/maps/markup/multimedia/render/saas/studio/upgrade), synced from official Remotion v4.0.529
 
 ## Requirements
 
@@ -39,7 +39,7 @@ Node.js ≥ 22 + npx (npm registry); rendering needs ffmpeg (guided by the skill
 
 ## Porting notes
 
-Synced from the official `remotion-dev/remotion` packages/skills (v4.0.519, 2026-08-31): hub symlinks materialized as real directories for cross-platform resolution.
+Synced from the official `remotion-dev/skills` checkout at v4.0.529 (2026-09-25): upstream skill bodies are vendored as-is, including the embedded reference copies under `remotion-best-practices/` and `remotion-markup/`, with `scripts/sync-skills.mjs` making the port repeatable and checkable. Only the frontmatter is ours (`name`/`description` plus the upstream `version`).
 
 ## Multi-harness
 

package/README.md

@@ -9,11 +9,11 @@
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 
 
-DSH（DeepSeek Harness）视频创作技能插件：**安装即把 Remotion 官方移植技能注册进 DSH**（React 编程式视频：动画、音频、字幕、3D、图表、字体等；同步 Remotion 官方 v4.0.519 的 12 技能结构）。
+DSH（DeepSeek Harness）视频创作技能插件：**安装即把 Remotion 官方移植技能注册进 DSH**（React 编程式视频：动画、音频、字幕、3D、图表、字体等；同步 Remotion 官方 v4.0.529 的 12 技能结构）。
 
 ## 兼容性
 
-已在官方 `@deepseek-ai/dsh@0.1.5-rc.1`、Node `24.16.0` 上验证（2026-09-11）：18 个组件与 Modlens 同载，工具 schema、技能注册及离线只读调用检查通过。采用 `cordis.patch.yml` + `dsh.bundle.patch` 组合包模型。Node 要求与该版本 Harness 一致：22.19 及以上的 22.x，或 24 及以上。外部服务的实际业务操作需按各组件配置单独验证。
+验证宿主：官方源码构建的 Harness `0.2.0-rc.1`（commit `407e65c8`）+ Node `24.16.0`（2026-09-28）。23 项插件测试在隔离环境全部通过；同一个宿主里 18 个插件共同加载，注册 12 个技能、1 个工具，工具 schema 与健康检查契约通过。本轮未启用真实端口与外部服务。
 
 ## 安装
 
@@ -34,7 +34,7 @@ dsh plugin --profile web remove dsh-remotion
 
 ## 技能内容
 
-- **remotion-best-practices**（总纲路由）+ 11 个领域技能（captions/create/docs/interactivity/maps/markup/multimedia/render/saas/studio/upgrade），同步自 Remotion 官方 v4.0.519
+- **remotion-best-practices**（总纲路由）+ 11 个领域技能（captions/create/docs/interactivity/maps/markup/multimedia/render/saas/studio/upgrade），同步自 Remotion 官方 v4.0.529
 
 ## 依赖
 
@@ -42,7 +42,7 @@ Node.js ≥ 22 + npx（npm registry）；渲染需 ffmpeg（Remotion 自带指
 
 ## 移植说明
 
-技能移植自 OpenAI Codex 官方 Remotion 插件缓存：frontmatter 已转换为 DSH 格式，codex 专属 `agents/` 已剔除，规则引用逐一校验。
+技能同步自官方 `remotion-dev/skills` 检出 v4.0.529（2026-09-25）：上游正文原样引入（含 `remotion-best-practices/`、`remotion-markup/` 下的内嵌引用副本），仅把 frontmatter 换成本包的 `name`/`description` + 上游 `version`；`scripts/sync-skills.mjs` 让移植可复现、可校验（`--check`）。
 
 ## 跨平台使用
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-remotion",
-  "version": "0.3.2",
-  "description": "DSH 视频创作技能插件：注册 Remotion 官方移植技能（React 编程式视频：动画/音频/字幕/3D/图表/字体，38 个规则文件），安装即用。",
+  "version": "0.3.4",
+  "description": "DSH 视频创作技能插件：注册 Remotion 官方 12 个技能（React 编程式视频：动画/音频/字幕/3D/地图/图表），安装即用。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -18,7 +18,8 @@
     "skills",
     "cordis.patch.yml",
     "README.md",
-    "README.en.md"
+    "README.en.md",
+    "scripts"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/scripts/.skill-port-meta.json

@@ -0,0 +1,50 @@
+{
+  "remotion-best-practices": {
+    "name": "remotion-best-practices",
+    "description": "Router for all Remotion skills"
+  },
+  "remotion-captions": {
+    "name": "remotion-captions",
+    "description": "Transcribing, displaying and animating captions"
+  },
+  "remotion-create": {
+    "name": "remotion-create",
+    "description": "Create a new Remotion video"
+  },
+  "remotion-docs": {
+    "name": "remotion-docs",
+    "description": "Search Remotion documentation"
+  },
+  "remotion-interactivity": {
+    "name": "remotion-interactivity",
+    "description": "Structure Remotion markup for interactivity"
+  },
+  "remotion-maps": {
+    "name": "remotion-maps",
+    "description": "Remotion Map animation knowledge"
+  },
+  "remotion-markup": {
+    "name": "remotion-markup",
+    "description": "Content, animation and effects best practices"
+  },
+  "remotion-multimedia": {
+    "name": "remotion-multimedia",
+    "description": "Interacting with Mediabunny"
+  },
+  "remotion-render": {
+    "name": "remotion-render",
+    "description": "Export a Remotion video"
+  },
+  "remotion-saas": {
+    "name": "remotion-saas",
+    "description": "Build an app with Remotion"
+  },
+  "remotion-studio": {
+    "name": "remotion-studio",
+    "description": "Preview a Remotion video"
+  },
+  "remotion-upgrade": {
+    "name": "remotion-upgrade",
+    "description": "Upgrade Remotion, and related packages"
+  }
+}

package/scripts/sync-skills.mjs

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/**
+ * Vendor the official Remotion Agent Skills into this package.
+ *
+ * Source of truth: https://github.com/remotion-dev/skills at a pinned version.
+ * The upstream skill bodies are the product content; only the frontmatter is
+ * ours: an Agent Skills `name`/`description` plus the upstream `version`, with
+ * every other upstream key (e.g. allowed-tools) dropped so DSH registration
+ * stays on the documented keys.
+ *
+ * Usage:
+ *   node scripts/sync-skills.mjs --upstream <path-to-remotion-dev/skills> [--check]
+ */
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs'
+import { join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { parseArgs } from 'node:util'
+
+const packageRoot = resolve(fileURLToPath(new URL('..', import.meta.url)))
+const { values } = parseArgs({ options: { upstream: { type: 'string' }, check: { type: 'boolean', default: false } } })
+if (!values.upstream) throw new Error('--upstream <path to a remotion-dev/skills checkout> is required')
+
+const upstreamSkills = resolve(values.upstream, 'skills')
+if (!existsSync(upstreamSkills)) throw new Error('No skills/ directory under ' + values.upstream)
+const targetSkills = join(packageRoot, 'skills')
+const meta = JSON.parse(readFileSync(join(packageRoot, 'scripts', '.skill-port-meta.json'), 'utf8'))
+
+/** Upstream frontmatter -> our frontmatter: keep only the documented keys. */
+const portFrontmatter = (text, fallback) => {
+  const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(text)
+  if (!match) throw new Error('Missing frontmatter for ' + fallback.name)
+  const version = /^version:\s*(.+)$/m.exec(match[1])?.[1]?.trim()
+  const name = /^name:\s*(.+)$/m.exec(match[1])?.[1]?.trim() ?? fallback.name
+  const description = /^description:\s*(.+)$/m.exec(match[1])?.[1]?.trim() ?? fallback.description
+  if (!version) throw new Error('Missing upstream version for ' + name)
+  return ['---', 'name: ' + name, 'description: ' + description, 'version: ' + version, '---', '', text.slice(match[0].length).replace(/^\n+/, '')].join('\n')
+}
+
+if (!values.check) rmSync(targetSkills, { recursive: true, force: true })
+mkdirSync(targetSkills, { recursive: true })
+
+const skills = readdirSync(upstreamSkills, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort()
+const drift = []
+for (const skill of skills) {
+  const from = join(upstreamSkills, skill)
+  const to = join(targetSkills, skill)
+  if (!values.check) cpSync(from, to, { recursive: true })
+  const fallback = meta[skill]
+  if (!fallback) throw new Error('No port metadata for upstream skill ' + skill + '; add it to scripts/.skill-port-meta.json')
+  const skillFile = join(to, 'SKILL.md')
+  if (!values.check) writeFileSync(skillFile, portFrontmatter(readFileSync(skillFile, 'utf8'), fallback))
+}
+
+// --check: the ported tree must match a fresh port of the same upstream
+if (values.check) {
+  for (const skill of skills) {
+    const ported = readFileSync(join(targetSkills, skill, 'SKILL.md'), 'utf8')
+    const expected = portFrontmatter(readFileSync(join(upstreamSkills, skill, 'SKILL.md'), 'utf8'), meta[skill])
+    if (ported.replace(/\r\n/g, '\n') !== expected.replace(/\r\n/g, '\n')) drift.push(skill)
+  }
+  if (drift.length) throw new Error('Ported skills drift from upstream: ' + drift.join(', '))
+  console.log('Ported skills match upstream ' + join(values.upstream, 'package.json') + ' (' + skills.length + ' skills).')
+} else {
+  console.log('Ported ' + skills.length + ' skills from ' + upstreamSkills + '. Rebuild and publish.')
+}

package/skills/remotion-best-practices/SKILL.md

@@ -1,8 +1,9 @@
----
-name: remotion-best-practices
-description: Router for all Remotion skills
-version: 4.0.519
----
+---
+name: remotion-best-practices
+description: Router for all Remotion skills
+version: 4.0.529
+---
+
 
 ## Preserve user changes
 
@@ -12,48 +13,48 @@ If you detect a surprising change made in the meanwhile, don't overwrite it, ass
 
 ## Creating a video
 
-If the user asks to make, create, or build a new video or composition, load [Create a new Remotion video](./remotion-create/SKILL.md), whether or not a Remotion project already exists.
+If the user asks to make, create, or build a new video or composition, load [Create a new Remotion video](./remotion-create/REFERENCE.md), whether or not a Remotion project already exists.
 
 ## New project setup
 
-If no Remotion project currently exists, load [Create a new Remotion project](./remotion-create/SKILL.md)
+If no Remotion project currently exists, load [Create a new Remotion project](./remotion-create/REFERENCE.md)
 
 ## React Markup Best Practices
 
-If you are writing Remotion React Markup, load [Remotion Markup Best Practices](./remotion-markup/SKILL.md)
+If you are writing Remotion React Markup, load [Remotion Markup Best Practices](./remotion-markup/REFERENCE.md)
 
 ## Maps
 
-For static maps, animated routes and markers, geographic explainers, Mapbox, MapLibre, MapTiler, GeoJSON, or 3D geographic flyovers, load [Remotion Maps](./remotion-maps/SKILL.md).
+For static maps, animated routes and markers, geographic explainers, Mapbox, MapLibre, MapTiler, GeoJSON, or 3D geographic flyovers, load [Remotion Maps](./remotion-maps/REFERENCE.md).
 
 ## Multimedia
 
-For achieving multimedia tasks in the browser, such as trimming, cropping videos, or getting metadata from them, load [Remotion Multimedia](./remotion-multimedia/SKILL.md)
+For achieving multimedia tasks in the browser, such as trimming, cropping videos, or getting metadata from them, load [Remotion Multimedia](./remotion-multimedia/REFERENCE.md)
 
 ## Improving Interactivity
 
-By structuring the Remotion markup well, we can allow users to interactively change things in the Studio and write back to code. If relevant: [Interactivity Best Practices](./remotion-interactivity/SKILL.md)
+By structuring the Remotion markup well, we can allow users to interactively change things in the Studio and write back to code. If relevant: [Interactivity Best Practices](./remotion-interactivity/REFERENCE.md)
 
 ## Rendering
 
-For advanced rendering beyond simple `npx remotion render`, see: [Rendering Best Practices](./remotion-render/SKILL.md)
+For advanced rendering beyond simple `npx remotion render`, see: [Rendering Best Practices](./remotion-render/REFERENCE.md)
 
 ## Opening Remotion Studio
 
-To launch a project in Remotion Studio, open its exact local URL, or configure Studio CLI flags, load [Remotion Studio](./remotion-studio/SKILL.md).
+To launch a project in Remotion Studio, open its exact local URL, or configure Studio CLI flags, load [Remotion Studio](./remotion-studio/REFERENCE.md).
 
 ## Captions
 
-When working with Captions, load [Remotion Captions](./remotion-captions/SKILL.md).
+When working with Captions, load [Remotion Captions](./remotion-captions/REFERENCE.md).
 
 ## Creating a SaaS, automation or application
 
-Use the [Remotion SaaS skill](./remotion-saas/SKILL.md) for knowledge about Remotion-powered SaaS apps, such as `<Player>`, rendering on Lambda, Vercel, Cloudflare, via Express.js, client-side rendering, or for finding the right SaaS template.
+Use the [Remotion SaaS skill](./remotion-saas/REFERENCE.md) for knowledge about Remotion-powered SaaS apps, such as `<Player>`, rendering on Lambda, Vercel, Cloudflare, via Express.js, client-side rendering, or for finding the right SaaS template.
 
 ## Looking up Remotion APIs and documentation
 
-To find and read current Remotion documentation, load [Remotion Docs](./remotion-docs/SKILL.md).
+To find and read current Remotion documentation, load [Remotion Docs](./remotion-docs/REFERENCE.md).
 
 ## Upgrading
 
-To upgrade Remotion, related packages, compatible Mediabunny packages, and installed Remotion Agent Skills, load [Remotion Upgrade](./remotion-upgrade/SKILL.md).
+To upgrade Remotion, related packages, compatible Mediabunny packages, and installed Remotion Agent Skills, load [Remotion Upgrade](./remotion-upgrade/REFERENCE.md).

package/skills/remotion-best-practices/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
   display_name: '/remotion-best-practices'
   short_description: 'Route Remotion tasks to the right workflow'
-  icon_small: './assets/remotion-icon.png'
-  icon_large: './assets/remotion-icon.png'
+  icon_small: './assets/remotion-icon.svg'
+  icon_large: './assets/remotion-icon.svg'
   brand_color: '#0B84F3'
   default_prompt: '$remotion-best-practices: Make a promo video for my product'

package/skills/remotion-best-practices/assets/remotion-icon.svg

@@ -0,0 +1,4 @@
+<svg width="100" height="100" viewBox="20 30 363 363" xmlns="http://www.w3.org/2000/svg">
+<title>Remotion</title>
+<path d="M148.332 92.9015C143.307 93.1742 139.259 93.9713 135.179 95.5236C133.144 96.2893 129.809 97.957 127.973 99.1108C120.295 103.925 114.443 111.162 111.391 119.584C110.782 121.252 109.136 126.57 108.076 130.23C101.018 154.7 97.0112 181.456 96.1511 209.776C96.0148 214.286 96.0148 225.026 96.1511 229.463C96.728 248.237 98.5216 265.187 101.773 282.472C103.095 289.468 105.213 298.866 106.44 303.135C108.947 311.809 114.065 319.193 121.344 324.605C126.221 328.234 131.759 330.668 137.895 331.863C140.853 332.44 144.755 332.702 147.629 332.514C151.604 332.251 159.491 331.192 165.9 330.049C194.786 324.899 221.469 315.679 245.666 302.485C260.99 294.125 274.09 285.074 286.729 274.092C299.326 263.163 310.066 251.405 319.516 238.21C321.708 235.158 322.81 233.375 323.911 231.131C326.743 225.341 328.075 219.583 328.064 213.143C328.064 207.143 326.932 201.815 324.488 196.361C323.313 193.728 322.191 191.84 319.674 188.253C310.402 175.048 300.112 163.542 287.568 152.361C268.122 135.034 245.026 120.822 219.235 110.302C213.644 108.026 208.138 106.022 201.509 103.851C187.475 99.2681 170.106 95.2929 155.411 93.3105C153.104 92.9959 149.968 92.8176 148.332 92.9015Z" fill="#0B84F3"/>
+</svg>

package/skills/remotion-best-practices/remotion-captions/{SKILL.md → REFERENCE.md}

@@ -1,7 +1,7 @@
 ---
 name: remotion-captions
 description: Transcribing, displaying and animating captions
-version: 4.0.519
+version: 4.0.529
 ---
 
 All captions must be processed in JSON. The captions must use the [`Caption`](https://www.remotion.dev/docs/captions/caption.md) type which is the following:

package/skills/remotion-best-practices/remotion-captions/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
   display_name: '/remotion-captions'
   short_description: 'Transcribe, display, and animate captions'
-  icon_small: './assets/remotion-icon.png'
-  icon_large: './assets/remotion-icon.png'
+  icon_small: './assets/remotion-icon.svg'
+  icon_large: './assets/remotion-icon.svg'
   brand_color: '#0B84F3'
   default_prompt: '$remotion-captions: Transcribe my video and display captions'

package/skills/remotion-best-practices/remotion-captions/assets/remotion-icon.svg

@@ -0,0 +1,4 @@
+<svg width="100" height="100" viewBox="20 30 363 363" xmlns="http://www.w3.org/2000/svg">
+<title>Remotion</title>
+<path d="M148.332 92.9015C143.307 93.1742 139.259 93.9713 135.179 95.5236C133.144 96.2893 129.809 97.957 127.973 99.1108C120.295 103.925 114.443 111.162 111.391 119.584C110.782 121.252 109.136 126.57 108.076 130.23C101.018 154.7 97.0112 181.456 96.1511 209.776C96.0148 214.286 96.0148 225.026 96.1511 229.463C96.728 248.237 98.5216 265.187 101.773 282.472C103.095 289.468 105.213 298.866 106.44 303.135C108.947 311.809 114.065 319.193 121.344 324.605C126.221 328.234 131.759 330.668 137.895 331.863C140.853 332.44 144.755 332.702 147.629 332.514C151.604 332.251 159.491 331.192 165.9 330.049C194.786 324.899 221.469 315.679 245.666 302.485C260.99 294.125 274.09 285.074 286.729 274.092C299.326 263.163 310.066 251.405 319.516 238.21C321.708 235.158 322.81 233.375 323.911 231.131C326.743 225.341 328.075 219.583 328.064 213.143C328.064 207.143 326.932 201.815 324.488 196.361C323.313 193.728 322.191 191.84 319.674 188.253C310.402 175.048 300.112 163.542 287.568 152.361C268.122 135.034 245.026 120.822 219.235 110.302C213.644 108.026 208.138 106.022 201.509 103.851C187.475 99.2681 170.106 95.2929 155.411 93.3105C153.104 92.9959 149.968 92.8176 148.332 92.9015Z" fill="#0B84F3"/>
+</svg>

package/skills/remotion-best-practices/remotion-create/{SKILL.md → REFERENCE.md}

@@ -1,31 +1,48 @@
 ---
 name: remotion-create
 description: Create a new Remotion video
-version: 4.0.519
+version: 4.0.529
 ---
 
 These are instructions for making a new Remotion project and composition.  
-If this is not the next task, see [Remotion Best Practices](../remotion-best-practices/SKILL.md)
+If this is not the next task, see [Remotion Best Practices](../SKILL.md)
 
 ## Scaffold a project
 
 If a project already exists, skip this.
 Ensure Node.js and Git is installed, and the current folder is appropriate for starting a new project.
 
-Scaffold one using:
+Inspect the current folder, including hidden files, before choosing where to scaffold.
+
+### Empty folder
+
+If it is empty, or contains only disposable operating-system metadata such as `.DS_Store`, create the project directly in the current folder.
+Remove only those disposable metadata files first, since `create-video` rejects non-empty folders.
+Do not treat all hidden files as disposable: files such as `.env` and directories such as `.git` are meaningful contents.
+
+Scaffold in existing folder:
 
 ```bash
-npx create-video@latest --yes --blank --no-tailwind my-video
-cd my-video
+npx create-video@latest --yes --blank --no-tailwind .
 npm i
 ```
 
+### Non-empty folder
+
+If the current folder contains meaningful contents and no project already exists, scaffold into a new subfolder.
 Replace `my-video` with a suitable project name.
 
+
+```bash
+npx create-video@latest --yes --blank --no-tailwind my-video
+cd my-video
+npm i
+```
+
 ## Designing a video
 
 Keep the scaffold and add React Markup.
-Follow [Remotion React Markup Best Practices](../remotion-markup/SKILL.md) and [Video Layout Rules](video-layout.md) for video-first layout and text sizing guidance.
+Follow [Remotion React Markup Best Practices](../remotion-markup/REFERENCE.md) and [Video Layout Rules](video-layout.md) for video-first layout and text sizing guidance.
 
 ## Is this a multi-scene video?
 
@@ -33,7 +50,7 @@ If this is a video with multiple subsequence videos, follow guidance at [Multi-s
 
 ## Interactivity Best Practices
 
-By structuring the React Markup following [Remotion Interactivity Best Practices](../remotion-interactivity/SKILL.md), you allow the user to make edits in the Studio which write back to code.
+By structuring the React Markup following [Remotion Interactivity Best Practices](../remotion-interactivity/REFERENCE.md), you allow the user to make edits in the Studio which write back to code.
 
 ## TailwindCSS
 
@@ -60,9 +77,9 @@ Only render if the user explicitly asks for it.
 npx remotion render
 ```
 
-For more options, see [Rendering](../remotion-render/SKILL.md).
+For more options, see [Rendering](../remotion-render/REFERENCE.md).
 
 ## Follow-up
 
 The video creation process has finished.
-For follow-up prompts, use [Remotion Best Practices](../remotion-best-practices/SKILL.md)
+For follow-up prompts, use [Remotion Best Practices](../SKILL.md)

package/skills/remotion-best-practices/remotion-create/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
   display_name: '/remotion-create'
   short_description: 'Create a new Remotion video project'
-  icon_small: './assets/remotion-icon.png'
-  icon_large: './assets/remotion-icon.png'
+  icon_small: './assets/remotion-icon.svg'
+  icon_large: './assets/remotion-icon.svg'
   brand_color: '#0B84F3'
   default_prompt: '$remotion-create: Create a Remotion video and make a promo for my product'

package/skills/remotion-best-practices/remotion-create/assets/remotion-icon.svg

@@ -0,0 +1,4 @@
+<svg width="100" height="100" viewBox="20 30 363 363" xmlns="http://www.w3.org/2000/svg">
+<title>Remotion</title>
+<path d="M148.332 92.9015C143.307 93.1742 139.259 93.9713 135.179 95.5236C133.144 96.2893 129.809 97.957 127.973 99.1108C120.295 103.925 114.443 111.162 111.391 119.584C110.782 121.252 109.136 126.57 108.076 130.23C101.018 154.7 97.0112 181.456 96.1511 209.776C96.0148 214.286 96.0148 225.026 96.1511 229.463C96.728 248.237 98.5216 265.187 101.773 282.472C103.095 289.468 105.213 298.866 106.44 303.135C108.947 311.809 114.065 319.193 121.344 324.605C126.221 328.234 131.759 330.668 137.895 331.863C140.853 332.44 144.755 332.702 147.629 332.514C151.604 332.251 159.491 331.192 165.9 330.049C194.786 324.899 221.469 315.679 245.666 302.485C260.99 294.125 274.09 285.074 286.729 274.092C299.326 263.163 310.066 251.405 319.516 238.21C321.708 235.158 322.81 233.375 323.911 231.131C326.743 225.341 328.075 219.583 328.064 213.143C328.064 207.143 326.932 201.815 324.488 196.361C323.313 193.728 322.191 191.84 319.674 188.253C310.402 175.048 300.112 163.542 287.568 152.361C268.122 135.034 245.026 120.822 219.235 110.302C213.644 108.026 208.138 106.022 201.509 103.851C187.475 99.2681 170.106 95.2929 155.411 93.3105C153.104 92.9959 149.968 92.8176 148.332 92.9015Z" fill="#0B84F3"/>
+</svg>

package/skills/remotion-best-practices/remotion-docs/{SKILL.md → REFERENCE.md}

@@ -1,11 +1,11 @@
 ---
 name: remotion-docs
 description: Search Remotion documentation
-version: 4.0.519
+version: 4.0.529
 ---
 
 This skill teaches you how to discover and read current Remotion documentation.
-If this is not relevant, load [Remotion Best Practices](../remotion-best-practices/SKILL.md) instead.
+If this is not relevant, load [Remotion Best Practices](../SKILL.md) instead.
 
 ## Searching the docs
 

package/skills/remotion-best-practices/remotion-docs/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
   display_name: '/remotion-docs'
   short_description: 'Search current Remotion documentation'
-  icon_small: './assets/remotion-icon.png'
-  icon_large: './assets/remotion-icon.png'
+  icon_small: './assets/remotion-icon.svg'
+  icon_large: './assets/remotion-icon.svg'
   brand_color: '#0B84F3'
   default_prompt: '$remotion-docs: What server-side rendering options does Remotion have?'

package/skills/remotion-best-practices/remotion-docs/assets/remotion-icon.svg

@@ -0,0 +1,4 @@
+<svg width="100" height="100" viewBox="20 30 363 363" xmlns="http://www.w3.org/2000/svg">
+<title>Remotion</title>
+<path d="M148.332 92.9015C143.307 93.1742 139.259 93.9713 135.179 95.5236C133.144 96.2893 129.809 97.957 127.973 99.1108C120.295 103.925 114.443 111.162 111.391 119.584C110.782 121.252 109.136 126.57 108.076 130.23C101.018 154.7 97.0112 181.456 96.1511 209.776C96.0148 214.286 96.0148 225.026 96.1511 229.463C96.728 248.237 98.5216 265.187 101.773 282.472C103.095 289.468 105.213 298.866 106.44 303.135C108.947 311.809 114.065 319.193 121.344 324.605C126.221 328.234 131.759 330.668 137.895 331.863C140.853 332.44 144.755 332.702 147.629 332.514C151.604 332.251 159.491 331.192 165.9 330.049C194.786 324.899 221.469 315.679 245.666 302.485C260.99 294.125 274.09 285.074 286.729 274.092C299.326 263.163 310.066 251.405 319.516 238.21C321.708 235.158 322.81 233.375 323.911 231.131C326.743 225.341 328.075 219.583 328.064 213.143C328.064 207.143 326.932 201.815 324.488 196.361C323.313 193.728 322.191 191.84 319.674 188.253C310.402 175.048 300.112 163.542 287.568 152.361C268.122 135.034 245.026 120.822 219.235 110.302C213.644 108.026 208.138 106.022 201.509 103.851C187.475 99.2681 170.106 95.2929 155.411 93.3105C153.104 92.9959 149.968 92.8176 148.332 92.9015Z" fill="#0B84F3"/>
+</svg>

package/skills/remotion-best-practices/remotion-interactivity/{SKILL.md → REFERENCE.md}

@@ -1,7 +1,7 @@
 ---
 name: remotion-interactivity
 description: Structure Remotion markup for interactivity
-version: 4.0.519
+version: 4.0.529
 ---
 
 By writing Remotion markup in a specific way, the Remotion Studio is able to recognize the structure of the code and makes it interactive:
@@ -147,6 +147,72 @@ const translateY = interpolate(frame, [0, 30], [0, 120]); // ❌ Math should be
 />
 ```
 
+## Keep SVG paths editable with `Interactive.Path`
+
+Use `<Interactive.Path>` from `remotion` instead of `<path>` inside an SVG to make the path visually editable.
+
+Install `@remotion/paths` for path interpolation and Studio path keyframes:
+
+```sh
+bunx remotion add @remotion/paths
+```
+
+If the geometry is meant to be static, put the path string directly in the `d` prop. Do not extract it into a constant.
+
+```tsx title="Editable static path"
+import {Interactive} from 'remotion';
+
+<Interactive.Svg width={300} height={300} viewBox="0 0 300 300">
+  <Interactive.Path
+    name="Triangle"
+    d="M 40 40 L 260 40 L 150 260 Z"
+    fill="#0b84f3"
+  />
+</Interactive.Svg>
+```
+
+### Morph paths using inline `interpolatePaths()`
+
+Use `interpolatePaths()` from `@remotion/paths` directly in `d`.  
+It accepts a frame, an input range, an equally sized array of path strings, and options for easing, extrapolation, and posterization.
+Keep the output paths, ranges, and options inline, following the same input-range rules as `interpolate()` above.  
+Do not use `interpolatePath()` API or extract the interpolated result into a variable when the path keyframes should remain editable in Studio.
+
+```tsx title="Editable path keyframes"
+import {interpolatePaths} from '@remotion/paths';
+import {Easing, Interactive, useCurrentFrame} from 'remotion';
+
+export const MorphingPath = () => {
+  const frame = useCurrentFrame();
+
+  return (
+    <Interactive.Svg width={300} height={300} viewBox="0 0 300 300">
+      <Interactive.Path
+        name="Morphing triangle"
+        d={interpolatePaths(
+          frame,
+          [0, 30, 60],
+          [
+            'M 40 40 L 260 40 L 150 260 Z',
+            'M 40 150 L 150 40 L 260 150 Z',
+            'M 40 260 L 150 40 L 260 260 Z',
+          ],
+          {
+            easing: Easing.bezier(0.42, 0, 0.58, 1),
+            extrapolateLeft: 'clamp',
+            extrapolateRight: 'clamp',
+          },
+        )}
+        fill="#0b84f3"
+      />
+    </Interactive.Svg>
+  );
+};
+```
+
+Studio can edit the path at the current frame, add or move keyframes, and adjust their easing.  
+Use `strokeDasharray` and `strokeDashoffset` to evolve paths.
+
 ## Use `scale`, `translate`, `rotate` CSS properties
 
 Avoid the `transform` CSS property.  
@@ -239,6 +305,8 @@ Render separate elements if one version should have effects and another should n
 
 ## Making your own component interactive
 
+When using `Interactive.withSchema()`, include `Interactive.baseSchema` in the schema so standard timeline controls such as trimming and visibility remain available.
+
 To make a custom userland component interactive, use:
 [Make a component interactive](https://www.remotion.dev/docs/studio/make-component-interactive.md)
 

package/skills/remotion-best-practices/remotion-interactivity/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
   display_name: '/remotion-interactivity'
   short_description: 'Make compositions editable in Remotion Studio'
-  icon_small: './assets/remotion-icon.png'
-  icon_large: './assets/remotion-icon.png'
+  icon_small: './assets/remotion-icon.svg'
+  icon_large: './assets/remotion-icon.svg'
   brand_color: '#0B84F3'
   default_prompt: '$remotion-interactivity: Make the markup in MyComp.tsx interactive'

package/skills/remotion-best-practices/remotion-interactivity/assets/remotion-icon.svg

@@ -0,0 +1,4 @@
+<svg width="100" height="100" viewBox="20 30 363 363" xmlns="http://www.w3.org/2000/svg">
+<title>Remotion</title>
+<path d="M148.332 92.9015C143.307 93.1742 139.259 93.9713 135.179 95.5236C133.144 96.2893 129.809 97.957 127.973 99.1108C120.295 103.925 114.443 111.162 111.391 119.584C110.782 121.252 109.136 126.57 108.076 130.23C101.018 154.7 97.0112 181.456 96.1511 209.776C96.0148 214.286 96.0148 225.026 96.1511 229.463C96.728 248.237 98.5216 265.187 101.773 282.472C103.095 289.468 105.213 298.866 106.44 303.135C108.947 311.809 114.065 319.193 121.344 324.605C126.221 328.234 131.759 330.668 137.895 331.863C140.853 332.44 144.755 332.702 147.629 332.514C151.604 332.251 159.491 331.192 165.9 330.049C194.786 324.899 221.469 315.679 245.666 302.485C260.99 294.125 274.09 285.074 286.729 274.092C299.326 263.163 310.066 251.405 319.516 238.21C321.708 235.158 322.81 233.375 323.911 231.131C326.743 225.341 328.075 219.583 328.064 213.143C328.064 207.143 326.932 201.815 324.488 196.361C323.313 193.728 322.191 191.84 319.674 188.253C310.402 175.048 300.112 163.542 287.568 152.361C268.122 135.034 245.026 120.822 219.235 110.302C213.644 108.026 208.138 106.022 201.509 103.851C187.475 99.2681 170.106 95.2929 155.411 93.3105C153.104 92.9959 149.968 92.8176 148.332 92.9015Z" fill="#0B84F3"/>
+</svg>

package/skills/{remotion-markup/remotion-maps/SKILL.md → remotion-best-practices/remotion-maps/REFERENCE.md}

@@ -1,7 +1,7 @@
 ---
 name: remotion-maps
 description: Remotion Map animation knowledge
-version: 4.0.519
+version: 4.0.529
 ---
 
 # Remotion Maps

package/skills/remotion-best-practices/remotion-maps/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
   display_name: '/remotion-maps'
   short_description: 'Create animated maps in Remotion videos'
-  icon_small: './assets/remotion-icon.png'
-  icon_large: './assets/remotion-icon.png'
+  icon_small: './assets/remotion-icon.svg'
+  icon_large: './assets/remotion-icon.svg'
   brand_color: '#0B84F3'
   default_prompt: '$remotion-maps: Animate a dot from Zurich to New York.'

package/skills/remotion-best-practices/remotion-maps/assets/remotion-icon.svg

@@ -0,0 +1,4 @@
+<svg width="100" height="100" viewBox="20 30 363 363" xmlns="http://www.w3.org/2000/svg">
+<title>Remotion</title>
+<path d="M148.332 92.9015C143.307 93.1742 139.259 93.9713 135.179 95.5236C133.144 96.2893 129.809 97.957 127.973 99.1108C120.295 103.925 114.443 111.162 111.391 119.584C110.782 121.252 109.136 126.57 108.076 130.23C101.018 154.7 97.0112 181.456 96.1511 209.776C96.0148 214.286 96.0148 225.026 96.1511 229.463C96.728 248.237 98.5216 265.187 101.773 282.472C103.095 289.468 105.213 298.866 106.44 303.135C108.947 311.809 114.065 319.193 121.344 324.605C126.221 328.234 131.759 330.668 137.895 331.863C140.853 332.44 144.755 332.702 147.629 332.514C151.604 332.251 159.491 331.192 165.9 330.049C194.786 324.899 221.469 315.679 245.666 302.485C260.99 294.125 274.09 285.074 286.729 274.092C299.326 263.163 310.066 251.405 319.516 238.21C321.708 235.158 322.81 233.375 323.911 231.131C326.743 225.341 328.075 219.583 328.064 213.143C328.064 207.143 326.932 201.815 324.488 196.361C323.313 193.728 322.191 191.84 319.674 188.253C310.402 175.048 300.112 163.542 287.568 152.361C268.122 135.034 245.026 120.822 219.235 110.302C213.644 108.026 208.138 106.022 201.509 103.851C187.475 99.2681 170.106 95.2929 155.411 93.3105C153.104 92.9959 149.968 92.8176 148.332 92.9015Z" fill="#0B84F3"/>
+</svg>