zai-org · AIwork4me · Sep 1, 2026 · Sep 1, 2026 · Sep 1, 2026
@@ -152,6 +152,36 @@
         "motion"
       ]
     },
+    {
+      "name": "zcode-remotion",
+      "source": "./plugins/zcode-remotion",
+      "displayName": "Remotion for ZCode",
+      "displayName_i18n": {
+        "en": "Remotion for ZCode",
+        "zh-CN": "Remotion for ZCode"
+      },
+      "description": "Create and verify Remotion videos in ZCode with official Agent Skills, environment preflight, autonomous visual QA, verified MP4 output, and compatibility-aware setup.",
+      "description_i18n": {
+        "en": "Create and verify Remotion videos in ZCode with official Agent Skills, environment preflight, autonomous visual QA, verified MP4 output, and compatibility-aware setup.",
+        "zh-CN": "在 ZCode 中可靠创建并校验 Remotion 视频：使用官方 Agent Skills，提供环境预检、自主静帧视觉 QA、MP4 产物校验和兼容性感知的安装流程。"
+      },
+      "version": "0.2.5",
+      "author": {
+        "name": "AIwork4me",
+        "url": "https://github.com/AIwork4me"
+      },
+      "category": "productivity",
+      "keywords": [
+        "remotion",
+        "zcode",
+        "video-generation",
+        "programmatic-video",
+        "animation",
+        "visual-qa",
+        "render",
+        "mp4"
+      ]
+    },
     {
       "name": "accounting-and-reporting",
       "source": "./plugins/accounting-and-reporting",

@@ -0,0 +1,28 @@
+{
+  "name": "zcode-remotion",
+  "description": "Create and verify Remotion videos in ZCode with official Agent Skills, environment preflight, autonomous visual QA, verified MP4 output, and compatibility-aware setup.",
+  "description_i18n": {
+    "en": "Create and verify Remotion videos in ZCode with official Agent Skills, environment preflight, autonomous visual QA, verified MP4 output, and compatibility-aware setup.",
+    "zh-CN": "在 ZCode 中可靠创建并校验 Remotion 视频：使用官方 Agent Skills，提供环境预检、自主静帧视觉 QA、MP4 产物校验和兼容性感知的安装流程。"
+  },
+  "version": "0.2.5",
+  "author": {
+    "name": "AIwork4me",
+    "url": "https://github.com/AIwork4me"
+  },
+  "homepage": "https://github.com/AIwork4me/zcode-remotion",
+  "repository": "https://github.com/AIwork4me/zcode-remotion",
+  "license": "MIT",
+  "keywords": [
+    "remotion",
+    "zcode",
+    "video-generation",
+    "programmatic-video",
+    "animation",
+    "visual-qa",
+    "render",
+    "mp4"
+  ],
+  "skills": "skills",
+  "commands": "commands"
+}
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZCode Remotion Plugin Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
@@ -0,0 +1,16 @@
+# NOTICE
+
+This plugin contains original ZCode integration-layer content (routing, environment checks, workflow guidance, helper scripts), licensed under the MIT License in `LICENSE`.
+
+The Remotion Agent Skills that this plugin bootstraps are **not redistributed** by this Marketplace package. They are fetched by the user's own machine from the official source with the official installer, for example:
+
+```text
+npx -y skills add remotion-dev/skills -s '*' -y --copy -g
+```
+
+The upstream Remotion Agent Skills and Remotion software are Copyright Remotion and remain subject to Remotion's own license terms. Review:
+
+- https://github.com/remotion-dev/remotion/blob/main/LICENSE.md
+- https://www.remotion.pro
+
+Eligibility for free use depends on the upstream license terms and the user's entity type. This integration does not alter or bypass those terms.
@@ -0,0 +1,111 @@
+# zcode-remotion
+
+[中文文档](./README_CN.md)
+
+Create and verify programmatic videos with Remotion directly from ZCode. The plugin keeps Remotion's official Agent Skills as the source of domain knowledge and adds the reliability layer around them: skill bootstrap, environment preflight, routing, autonomous representative-frame visual QA, final MP4 verification, and a recorded compatibility baseline.
+
+**One prompt → official Remotion skills → visual QA → verified MP4.**
+
+Source project: https://github.com/AIwork4me/zcode-remotion
+
+## Install
+
+In ZCode, open **Settings → Plugins**, search the official marketplace for **zcode-remotion** (display name: **Remotion for ZCode**), then install and enable it.
+
+Requirements:
+
+- Node.js 18 or newer (20/22/24 recommended)
+- Network access for first-time package / skill / browser downloads
+- A writable project directory for generated Remotion projects and outputs
+
+The plugin itself has no API key, account, MCP server, hook, or background-service requirement.
+
+## Quick start
+
+Just ask for a video, for example:
+
+```text
+Create a 10-second product promo video for an AI coding agent. 16:9, modern technical style, and deliver the final MP4.
+```
+
+The bundled `remotion` skill will:
+
+1. verify that the official Remotion Agent Skills are present and complete;
+2. bootstrap or repair them with the official installer when needed;
+3. check Node and the project package manager;
+4. route the task to the relevant official Remotion skill;
+5. render a representative still and inspect it for objective visual defects;
+6. fix obvious issues before the expensive full render; and
+7. render and verify the final MP4 before reporting success.
+
+The bundled command picker also exposes workflows for **remotion-setup**, **remotion-doctor**, and **remotion-update**.
+
+## What this plugin adds
+
+| Capability | Behavior |
+| --- | --- |
+| Official skill bootstrap | Installs / repairs the official `remotion-dev/skills` set instead of vendoring a copy |
+| Skill integrity | Verifies the expected skill set on disk; a partial install is repaired in the same scope |
+| Environment preflight | Checks Node, package-manager context, Remotion project state, and render prerequisites |
+| Routing | Maps creation, markup, captions, maps, Studio, render, multimedia, upgrade, docs, SaaS and interactivity requests to the corresponding official skills |
+| Autonomous visual QA | Renders and visually inspects a representative still before a full render; asks the user only for subjective or low-confidence decisions |
+| Output verification | Confirms the MP4 exists and is non-empty; uses `ffprobe` for duration / dimensions when available |
+| Compatibility awareness | Ships a machine-readable tested baseline for Remotion, official skills and Mediabunny |
+
+## Current tested baseline
+
+The Marketplace package records the compatibility state in `compatibility/remotion.json`:
+
+- Remotion `4.0.520`
+- official Remotion Agent Skills `4.0.520` — 12 skills
+- Mediabunny `1.55.5`
+
+This is a **last verified baseline**, not a claim that newer releases are incompatible. The doctor / update workflows distinguish installed versions, latest upstream versions, and the recorded baseline.
+
+## Network access and side effects
+
+Enabling the plugin itself only registers its Markdown skill and commands. When you use its workflows, the Agent may execute local commands and access the network on your behalf.
+
+### Network access
+
+Depending on the task, it may contact:
+
+- npm registry, through `npm` / `npx` or the detected package manager;
+- GitHub, primarily `remotion-dev/skills` for the official Agent Skills;
+- Remotion documentation / release pages for version and upgrade guidance; and
+- Remotion's browser download endpoints when Chrome Headless Shell is required for rendering.
+
+### Local commands
+
+Typical commands include:
+
+- `node` / `npx`;
+- the detected package manager (`npm`, `pnpm`, `yarn`, or `bun`);
+- official Remotion CLI commands such as `remotion studio`, `remotion still`, `remotion render`, `remotion versions`, `remotion upgrade`, and `remotion browser ensure`;
+- the official `skills` installer; and
+- optional `ffprobe` for final media metadata verification.
+
+### File writes
+
+The workflows can write:
+
+- Remotion project files and dependencies in the user's chosen project directory;
+- rendered stills and MP4 outputs in the project;
+- official Remotion skills into user scope (`~/.zcode/skills/` / `~/.agents/skills/`) or project scope (`.zcode/skills/`) according to the requested scope.
+
+The plugin does **not** install hooks, register MCP servers, request credentials, or silently write long-term data outside these documented paths.
+
+## Official Remotion Skills and licensing
+
+This plugin does **not** redistribute Remotion's official Agent Skills. It invokes the official installer so the user's machine fetches them from the official source.
+
+- This integration layer is MIT licensed; see `LICENSE`.
+- The upstream Remotion Agent Skills and Remotion software remain under Remotion's own licensing terms; see `NOTICE.md` and https://www.remotion.pro.
+
+## Skill discovery after bootstrap
+
+The plugin's own skill and commands are registered when the plugin is enabled. The Remotion skills installed by the external official installer are separate skill files. After creating or updating them, open **Settings → Skills**, click **Refresh**, and confirm they are listed and enabled. Start a new conversation only if Refresh does not surface them.
+
+## Provenance
+
+This Marketplace package is derived from `AIwork4me/zcode-remotion` v0.2.5. Repository-only CI, demos, verification reports, tests, release tooling and drift automation are intentionally not included in the installable Marketplace artifact. See `UPSTREAM.md` for the packaging notes.
@@ -0,0 +1,111 @@
+# zcode-remotion
+
+[English](./README.md)
+
+在 ZCode 中直接创建并校验 Remotion 程序化视频。插件继续以 Remotion 官方 Agent Skills 作为领域知识来源，只补上可靠性层：官方技能引导安装、环境预检、任务路由、自主代表性静帧视觉 QA、最终 MP4 校验，以及可追溯的兼容性基线。
+
+**一句提示 → Remotion 官方技能 → 视觉 QA → 校验过的 MP4。**
+
+源项目：https://github.com/AIwork4me/zcode-remotion
+
+## 安装
+
+在 ZCode 中打开 **设置 → 插件**，在官方插件市场搜索 **zcode-remotion**（显示名：**Remotion for ZCode**），安装并启用即可。
+
+要求：
+
+- Node.js 18 或更高版本（推荐 20/22/24）
+- 首次下载包、技能和浏览器组件时需要网络访问
+- 用于创建 Remotion 项目和输出文件的可写目录
+
+插件本身不需要 API Key、账号、MCP Server、Hook 或后台服务。
+
+## 快速开始
+
+直接描述你要的视频，例如：
+
+```text
+帮我做一个 10 秒的 AI 编程助手产品宣传视频，16:9，现代科技感，并交付最终 MP4。
+```
+
+插件自带的 `remotion` 技能会：
+
+1. 检查 Remotion 官方 Agent Skills 是否已完整安装；
+2. 如缺失或不完整，调用官方安装器在原作用域内安装 / 修复；
+3. 检查 Node 和当前项目的包管理器环境；
+4. 把任务路由到对应的 Remotion 官方技能；
+5. 先渲染代表性静帧，并自主检查客观视觉问题；
+6. 在全量渲染前先修复明显问题；
+7. 完成渲染后校验 MP4，再向用户报告成功。
+
+插件的 Commands 列表还提供 **remotion-setup**、**remotion-doctor** 和 **remotion-update** 三条维护工作流。
+
+## 插件补上的可靠性能力
+
+| 能力 | 行为 |
+| --- | --- |
+| 官方技能引导安装 | 调用官方 `remotion-dev/skills` 安装器，不在插件中复制官方技能 |
+| 技能完整性检查 | 按预期技能集合检查磁盘；局部安装会在同一作用域内修复 |
+| 环境预检 | 检查 Node、包管理器、Remotion 项目状态和渲染前提 |
+| 任务路由 | 将创建、组件编写、字幕、地图、Studio、渲染、多媒体、升级、文档、SaaS、交互等请求路由到对应官方技能 |
+| 自主视觉 QA | 全量渲染前先生成代表性静帧并由 Agent 检查；仅在主观选择、品牌歧义或低置信度时询问用户 |
+| 产物校验 | 确认 MP4 存在且非空；若有 `ffprobe`，进一步检查时长和分辨率 |
+| 兼容性感知 | 随插件携带 Remotion、官方技能和 Mediabunny 的机器可读验证基线 |
+
+## 当前验证基线
+
+Marketplace 包中的 `compatibility/remotion.json` 记录：
+
+- Remotion `4.0.520`
+- Remotion 官方 Agent Skills `4.0.520` — 共 12 个
+- Mediabunny `1.55.5`
+
+这是**最近一次真实验证通过的基线**，并不意味着更新版本不兼容。doctor / update 工作流会明确区分：当前安装版本、上游最新版本、以及插件记录的验证基线。
+
+## 网络访问与副作用
+
+启用插件本身只会注册 Markdown 技能和命令。真正执行工作流时，Agent 会根据任务在本机运行命令，并可能访问网络。
+
+### 网络访问
+
+根据任务不同，可能访问：
+
+- npm registry，通过 `npm` / `npx` 或当前项目的包管理器；
+- GitHub，主要用于从 `remotion-dev/skills` 获取 Remotion 官方 Agent Skills；
+- Remotion 官方文档 / Release 页面，用于版本与升级信息；
+- Remotion 的浏览器下载地址，在渲染需要 Chrome Headless Shell 时下载组件。
+
+### 本地命令
+
+典型命令包括：
+
+- `node` / `npx`；
+- 当前项目使用的包管理器（`npm`、`pnpm`、`yarn` 或 `bun`）；
+- Remotion 官方 CLI，例如 `remotion studio`、`remotion still`、`remotion render`、`remotion versions`、`remotion upgrade`、`remotion browser ensure`；
+- 官方 `skills` 安装器；
+- 可选的 `ffprobe`，用于最终媒体元数据校验。
+
+### 文件写入
+
+工作流可能写入：
+
+- 用户指定项目目录里的 Remotion 源码和依赖；
+- 项目中的静帧与 MP4 输出；
+- 用户作用域的官方 Remotion 技能（`~/.zcode/skills/` / `~/.agents/skills/`），或按用户明确要求写入项目作用域 `.zcode/skills/`。
+
+插件**不会**安装 Hook、注册 MCP Server、索要凭据，也不会在上述已说明路径之外静默写入长期数据。
+
+## Remotion 官方技能与许可证
+
+本插件**不重新分发** Remotion 官方 Agent Skills，而是调用官方安装器，让用户机器直接从官方来源获取。
+
+- 本集成层使用 MIT License，见 `LICENSE`。
+- Remotion 官方 Agent Skills 与 Remotion 软件继续遵循 Remotion 自己的许可证条款，见 `NOTICE.md` 和 https://www.remotion.pro。
+
+## 引导安装后的技能发现
+
+插件自带的 skill 和 commands 在启用插件时自动注册。通过官方安装器外部安装的 Remotion Skills 属于独立技能文件；新建或更新后，请打开 **设置 → 技能**，点击 **刷新**，确认技能已列出并启用。只有刷新后仍未出现时，再新建会话。
+
+## 来源与打包说明
+
+本 Marketplace 包基于 `AIwork4me/zcode-remotion` v0.2.5。源仓中的 CI、demo、验证报告、测试、Release 工具和上游漂移自动化属于维护侧资产，不进入用户安装包。具体差异见 `UPSTREAM.md`。
@@ -0,0 +1,27 @@
+# Upstream and provenance
+
+This Marketplace package is a **curated distribution adaptation**, not a byte-for-byte mirror, of:
+
+- Source repository: https://github.com/AIwork4me/zcode-remotion
+- Source version: `0.2.5`
+- Source main commit used as the functional baseline: `2a9903c2cfc167f11cbec3009a2d7b2161b03492`
+
+The product boundary is unchanged: Remotion's official Agent Skills provide Remotion domain knowledge; zcode-remotion adds ZCode-specific bootstrap, environment checks, routing, autonomous representative-frame visual QA, output verification, and compatibility awareness.
+
+## Marketplace-specific adaptations
+
+The official Marketplace package intentionally excludes repository-maintenance assets such as CI workflows, demos, verification reports, source-project unit tests, release checks, and upstream-drift automation.
+
+The installable layer is adapted for Marketplace distribution in these ways:
+
+1. Add the bilingual `description_i18n` metadata required by this Marketplace.
+2. Provide Marketplace-specific English and Chinese READMEs that disclose network access, local command execution, file writes, dependencies, side effects, and licensing.
+3. Refactor helper-script instructions so they resolve the installed plugin root through `ZCODE_PLUGIN_ROOT` instead of assuming the user's current workspace is the source repository.
+4. Tighten and de-duplicate the Agent-facing skill / command instructions while preserving the same official-first workflow and reliability gates.
+5. Use the Marketplace plugin ID `zcode-remotion` rather than the bare upstream product name `remotion`; the bundled auto-trigger skill remains named `remotion`.
+
+Because this is not byte-identical to the source repository release, source-project E2E / CI evidence is background evidence only. The official Marketplace artifact must pass this repository's own validation/build/tests and a live ZCode install check before the submission is considered verified.
+
+## Third-party material
+
+No Remotion Agent Skill is vendored in this package. The plugin asks the user's machine to fetch official skills from `remotion-dev/skills` using the official installer. See `NOTICE.md` for licensing details.