From 863d00b97c3890da484601e0461e4534f79a20d8 Mon Sep 17 00:00:00 2001 From: hwj123hwj <130386673+hwj123hwj@users.noreply.github.com> Date: Fri, 25 Sep 2026 07:28:39 +0000 Subject: [PATCH] chore: sync upstream skills --- skills/brand-guidelines/SKILL.md | 3 +- skills/canvas-design/SKILL.md | 3 +- skills/doc-coauthoring/SKILL.md | 3 +- skills/docx/SKILL.md | 3 +- skills/frontend-design/SKILL.md | 3 +- skills/guizang-product-video-skill/SKILL.md | 7 +- skills/internal-comms/SKILL.md | 3 +- skills/mcp-builder/SKILL.md | 3 +- skills/pdf/SKILL.md | 3 +- skills/pptx/SKILL.md | 3 +- skills/remotion-best-practices/SKILL.md | 5 +- .../remotion-captions/REFERENCE.md | 2 +- .../remotion-create/REFERENCE.md | 2 +- .../remotion-docs/REFERENCE.md | 2 +- .../remotion-interactivity/REFERENCE.md | 2 +- .../remotion-maps/REFERENCE.md | 2 +- .../remotion-markup/REFERENCE.md | 29 ++-- .../remotion-markup/audio.md | 8 +- .../remotion-markup/compositions.md | 16 ++- .../remotion-markup/connected-compositions.md | 79 +++++++++++ .../remotion-markup/embedding-videos.md | 8 +- .../remotion-markup/multi-scene-video.md | 128 +++++++++--------- .../remotion-maps/REFERENCE.md | 2 +- .../remotion-multimedia/REFERENCE.md | 2 +- .../remotion-render/REFERENCE.md | 10 +- .../remotion-saas/REFERENCE.md | 2 +- .../remotion-saas/framework.md | 4 +- .../remotion-studio/REFERENCE.md | 2 +- .../remotion-upgrade/REFERENCE.md | 2 +- skills/talk-video-studio/SKILL.md | 6 +- skills/theme-factory/SKILL.md | 3 +- skills/web-artifacts-builder/SKILL.md | 3 +- skills/webapp-testing/SKILL.md | 3 +- skills/xlsx/SKILL.md | 3 +- 34 files changed, 228 insertions(+), 131 deletions(-) create mode 100644 skills/remotion-best-practices/remotion-markup/connected-compositions.md diff --git a/skills/brand-guidelines/SKILL.md b/skills/brand-guidelines/SKILL.md index b785137..03d035a 100644 --- a/skills/brand-guidelines/SKILL.md +++ b/skills/brand-guidelines/SKILL.md @@ -8,10 +8,11 @@ description: Applies Anthropic's official brand colors and typography to any sor license: Complete terms in LICENSE.txt upstream: anthropics/skills upstreamPath: skills/brand-guidelines -upstreamSha: 34040c9c568585f6929bedeaad110ad08f079624 +upstreamSha: 33375500bcea98d610eb30ce10ac4e59b89c390d author: anthropics --- --- +--- # Anthropic Brand Styling diff --git a/skills/canvas-design/SKILL.md b/skills/canvas-design/SKILL.md index 81e5261..572f4f1 100644 --- a/skills/canvas-design/SKILL.md +++ b/skills/canvas-design/SKILL.md @@ -8,10 +8,11 @@ description: Create beautiful visual art in .png and .pdf documents using design license: Complete terms in LICENSE.txt upstream: anthropics/skills upstreamPath: skills/canvas-design -upstreamSha: 34040c9c568585f6929bedeaad110ad08f079624 +upstreamSha: 33375500bcea98d610eb30ce10ac4e59b89c390d author: anthropics --- --- +--- These are instructions for creating design philosophies - aesthetic movements that are then EXPRESSED VISUALLY. Output only .md files, .pdf files, and .png files. diff --git a/skills/doc-coauthoring/SKILL.md b/skills/doc-coauthoring/SKILL.md index b7124f0..f052c70 100644 --- a/skills/doc-coauthoring/SKILL.md +++ b/skills/doc-coauthoring/SKILL.md @@ -9,10 +9,11 @@ description: Guide users through a structured workflow for co-authoring document similar documentation tasks. upstream: anthropics/skills upstreamPath: skills/doc-coauthoring -upstreamSha: 34040c9c568585f6929bedeaad110ad08f079624 +upstreamSha: 33375500bcea98d610eb30ce10ac4e59b89c390d author: anthropics --- --- +--- # Doc Co-Authoring Workflow diff --git a/skills/docx/SKILL.md b/skills/docx/SKILL.md index 1933eee..3f7f34f 100644 --- a/skills/docx/SKILL.md +++ b/skills/docx/SKILL.md @@ -15,10 +15,11 @@ description: 'Use this skill whenever the user wants to create, read, edit, or m license: Proprietary. LICENSE.txt has complete terms upstream: anthropics/skills upstreamPath: skills/docx -upstreamSha: 34040c9c568585f6929bedeaad110ad08f079624 +upstreamSha: 33375500bcea98d610eb30ce10ac4e59b89c390d author: anthropics --- --- +--- # DOCX creation, editing, and analysis diff --git a/skills/frontend-design/SKILL.md b/skills/frontend-design/SKILL.md index 1d5737d..df8acf4 100644 --- a/skills/frontend-design/SKILL.md +++ b/skills/frontend-design/SKILL.md @@ -7,10 +7,11 @@ description: Guidance for distinctive, intentional visual design when building n license: Complete terms in LICENSE.txt upstream: anthropics/skills upstreamPath: skills/frontend-design -upstreamSha: 34040c9c568585f6929bedeaad110ad08f079624 +upstreamSha: 33375500bcea98d610eb30ce10ac4e59b89c390d author: anthropics --- --- +--- # Frontend Design diff --git a/skills/guizang-product-video-skill/SKILL.md b/skills/guizang-product-video-skill/SKILL.md index d2194de..8ad27b9 100644 --- a/skills/guizang-product-video-skill/SKILL.md +++ b/skills/guizang-product-video-skill/SKILL.md @@ -15,8 +15,13 @@ license: "AGPL-3.0; CodePilot fallback assets: BUSL-1.1 (see README.md)" ## 流程 +<<<<<<< /home/runner/work/easycode-skills/easycode-skills/skills/guizang-product-video-skill/SKILL.md 1. **确认范围与三个选择。** 已有工程沿用 brief 和用户决定，只处理本次修改。新片先补齐产品/仓库、版本范围、发布平台、时长与画幅、语言和链接要求，再用一次 `ask_user_question` 问清三件会改变工作量的事：**风格**（`repo` 沿用产品设计／`default` 默认暖白炭黑／`hybrid` 保留产品识别并调整外层排版）、**动效**（界面操作动效 + 镜头 zoom in/out／只做界面动效／只做镜头推拉／全静态）、**旁白**（要 Gemini 画外音／只要字幕与音效／稍后再定）。用户已经指定、或已有工程里记过答案时不要重复问；旧工程缺 `motion` 或 `voiceoverRequired` 时补问一次写进 plan 再继续（脚本对缺失只告警，对自相矛盾才报错）。答案写进 `plan.json` 的 `motion.uiEffects`、`motion.cameraMove` 和 `voiceoverRequired`；用户否决的一项用 `motion.exceptionReason` 或 `voiceoverExceptionReason` 留下依据。旁白选定为「要」时**当场**解析 `EASYROUTER_API_KEY`（环境变量或视频工程 `.env`）：缺就立刻向用户索取，不要等画面做完——申请 key 要用户花时间，而它挡的是混音不是渲染，拖到最后才发现等于让用户白等整轮制作。普通场景可建议横版、45–60 秒、中文。 2. **初始化后检查环境。** 风格确定后，按下方工具入口初始化独立视频目录，再运行环境检查。把第 1 步的旁白答案传给检查脚本（`--voiceover yes|no|undecided`）：只有 `yes` 时 `EASYROUTER_API_KEY` 会作为 `prereqs` 报出来，`undecided` 只给告警。**不要改用 `plan.json` 的 `voiceoverRequired`**——此刻 plan 还是起步工程的技术样片，那个字段是过期的，读它会静默压掉提示。仅对报告的缺项加载 [依赖安装](references/onboarding.md) 并补装（`prereqs` 是用户提供的凭据，你装不了，只能索取），随后 `--force` 复查；`ready:true` 继续制作。已有工程直接检查，无需再次初始化。Python 本身缺失时先按依赖安装文档补齐 Python。检查每次执行，安装文档按缺项加载；browser 每次重查环境并实际启动浏览器，`cached:true` 仅表示环境指纹匹配上次成功记录；HyperFrames 指纹匹配时可跳过 doctor。 +======= +1. **确认范围、平台与风格。** 已有工程沿用 brief 和用户决定，只处理本次修改。新片优先补齐产品/仓库、时长与画幅、语言和链接要求，再用一次提问问清**范围与平台**：宣传片覆盖**全量产品介绍、最新一个版本周期，还是用户指定的版本区间**？覆盖**哪些平台面**（桌面端／CLI/TUI／移动端／服务端 API）？仓库记录只能说明「有哪些版本」，说明不了「用户想宣传哪个范围和面」——这一项必须由用户拍板，不要默认替用户决定。答案写入 `plan.json` 的 `scope`（如 `{"versions":"v0.10.12..v0.11.0","platforms":["cli-tui"]}`）并同步进 BRIEF；未纳入的平台面在交付时明确声明，避免观众误以为宣传片覆盖产品全貌。范围与平台尚未确定时问一次；用户已经指定时直接执行。**风格**也在此一并确认：“沿用代码库自己的设计风格（推荐），还是默认的暖白／炭黑风格？” `repo` 使用产品设计；`default` 使用默认样式包装；`hybrid` 保留产品识别并调整外层排版。普通场景可建议横版、45–60 秒、中文。 +2. **初始化后检查环境。** 风格确定后，按下方工具入口初始化独立视频目录，再运行环境检查。仅对报告的缺项加载 [依赖安装](references/onboarding.md) 并补装，随后复查；`ready:true` 继续制作。已有工程直接检查，无需再次初始化。Python 本身缺失时先按依赖安装文档补齐 Python。检查每次执行，安装文档按缺项加载；browser 每次重查环境并实际启动浏览器，`cached:true` 仅表示环境指纹匹配上次成功记录；HyperFrames 指纹匹配时可跳过 doctor。 +>>>>>>> /tmp/easycode-skill-sync-20260925-2351-p6rqvi/op7418_guizang-product-video-skill-current/SKILL.md 3. **调查更新并接通组件。** 按 [仓库与风格审计](references/repo-and-style.md) 确定日期/版本、发布状态和 3–5 组核心变化。找到对应业务组件、完整样式和所需状态，先接通一个功能镜头。React 项目的依赖解析、CSS/Tailwind 接入见 [起步工程](references/starter.md)，其他挂载路径见 [组件接入](references/component-pipeline.md)。 4. **编排画面与文案。** 按 [分镜与文案](references/story-and-copy.md) 写解释、标题、动作及阅读时间，交替安排字卡、组件特写、工作区和细节。用真实渲染路径输出 3–6 张关键静帧自检；用户要求先看方向时等反馈，否则继续。默认样式可先看 [标题预览](assets/fallback/title-preview.png) 与 [组件预览](assets/fallback/preview.png)。 5. **完成动效与声音。** 用主时间轴控制组件状态和镜头，支持前后 seek；界面动效与镜头推拉按 [分镜与文案](references/story-and-copy.md) 的镜头语言执行，动效对应真实状态变化，缩放后重新核对变换后的边界。按 [配乐与音效来源](references/audio-sourcing.md) 为当前影片代码原创配乐，先查找适合产品和动作的音效，缺项才用内置 WAV；用户要旁白时**先用候选音色各试一句、量出这部片子自己的语速**，再按它决定每句长度，然后用 `scripts/make_voiceover.py` 按镜头逐句生成并量出实际时长（旁白语速靠选音色和写短句子来调，见 [配乐与音效来源](references/audio-sourcing.md)）。按 [混音与验收](references/audio-and-qa.md) 对齐 `audio.cues` 与 `audio.voiceover`、压低关键音效与人声期间的音乐并完成混音。 @@ -24,7 +29,7 @@ license: "AGPL-3.0; CodePilot fallback assets: BUSL-1.1 (see README.md)" ## 硬约束 -- **真实功能。** 正式片至少一项可追溯的更新主张；每项记录发布状态、来源和白话解释。演示数据可固定，功能效果与数字应有证据。 +- **真实功能。** 正式片至少一项可追溯的更新主张；每项记录发布状态、来源和白话解释。演示数据可固定，功能效果与数字应有证据。范围与平台以 `plan.scope` 为准，交付时声明未覆盖的平台面。 - **原组件。** 功能镜头优先接入实际业务组件、原样式及状态；抽象化用于取景、布局和外层动画。逐镜头核对导入图、来源与静帧。平台确实无法接入时记录阻碍和替代方式，遵从已有授权。 - **清楚排版。** 宣传标题默认有意义的英文与中文各占一个 span、分别指定字体，中文无衬线；中文说明交代对象、动作和结果。原产品内部字体保持其设计；用户指定的语言/字体优先。 - **完整声音。** 默认代码原创音乐与独立动作音效均入轨，关键反馈可闻、音画同步。用户要求静音或省略音效时，记录 `audioExceptionReason`；该字段保存用户依据。 diff --git a/skills/internal-comms/SKILL.md b/skills/internal-comms/SKILL.md index 38f91d4..45b38c9 100644 --- a/skills/internal-comms/SKILL.md +++ b/skills/internal-comms/SKILL.md @@ -9,10 +9,11 @@ description: A set of resources to help me write all kinds of internal communica license: Complete terms in LICENSE.txt upstream: anthropics/skills upstreamPath: skills/internal-comms -upstreamSha: 34040c9c568585f6929bedeaad110ad08f079624 +upstreamSha: 33375500bcea98d610eb30ce10ac4e59b89c390d author: anthropics --- --- +--- ## When to use this skill To write internal communications, use this skill for: diff --git a/skills/mcp-builder/SKILL.md b/skills/mcp-builder/SKILL.md index b4c6d79..b37d77d 100644 --- a/skills/mcp-builder/SKILL.md +++ b/skills/mcp-builder/SKILL.md @@ -8,10 +8,11 @@ description: Guide for creating high-quality MCP (Model Context Protocol) server license: Complete terms in LICENSE.txt upstream: anthropics/skills upstreamPath: skills/mcp-builder -upstreamSha: 34040c9c568585f6929bedeaad110ad08f079624 +upstreamSha: 33375500bcea98d610eb30ce10ac4e59b89c390d author: anthropics --- --- +--- # MCP Server Development Guide diff --git a/skills/pdf/SKILL.md b/skills/pdf/SKILL.md index 3b6b0f4..986f67b 100644 --- a/skills/pdf/SKILL.md +++ b/skills/pdf/SKILL.md @@ -10,10 +10,11 @@ description: Use this skill whenever the user wants to do anything with PDF file license: Proprietary. LICENSE.txt has complete terms upstream: anthropics/skills upstreamPath: skills/pdf -upstreamSha: 34040c9c568585f6929bedeaad110ad08f079624 +upstreamSha: 33375500bcea98d610eb30ce10ac4e59b89c390d author: anthropics --- --- +--- # PDF Processing Guide diff --git a/skills/pptx/SKILL.md b/skills/pptx/SKILL.md index e11255f..4de54d0 100644 --- a/skills/pptx/SKILL.md +++ b/skills/pptx/SKILL.md @@ -13,10 +13,11 @@ description: 'Use this skill any time a .pptx or .potx file is involved in any w license: Proprietary. LICENSE.txt has complete terms upstream: anthropics/skills upstreamPath: skills/pptx -upstreamSha: 34040c9c568585f6929bedeaad110ad08f079624 +upstreamSha: 33375500bcea98d610eb30ce10ac4e59b89c390d author: anthropics --- --- +--- # PPTX creation, editing, and analysis diff --git a/skills/remotion-best-practices/SKILL.md b/skills/remotion-best-practices/SKILL.md index 7fa60e6..df893e8 100644 --- a/skills/remotion-best-practices/SKILL.md +++ b/skills/remotion-best-practices/SKILL.md @@ -1,16 +1,17 @@ --- name: remotion-best-practices description: Router for all Remotion skills -version: 4.0.526 +version: 4.0.528 category: 视频创作 tags: remotion, video, react, animation, composition upstream: remotion-dev/skills upstreamPath: skills/remotion-best-practices -upstreamSha: bbb139d5ba3709b1ffeb27184e9579c681230a08 +upstreamSha: 41b22eec767aa77eb31df62ccb3bacf52ed771fb author: remotion-dev --- --- --- +--- ## Preserve user changes diff --git a/skills/remotion-best-practices/remotion-captions/REFERENCE.md b/skills/remotion-best-practices/remotion-captions/REFERENCE.md index e97cd98..c85bbae 100644 --- a/skills/remotion-best-practices/remotion-captions/REFERENCE.md +++ b/skills/remotion-best-practices/remotion-captions/REFERENCE.md @@ -1,7 +1,7 @@ --- name: remotion-captions description: Transcribing, displaying and animating captions -version: 4.0.526 +version: 4.0.528 --- 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: diff --git a/skills/remotion-best-practices/remotion-create/REFERENCE.md b/skills/remotion-best-practices/remotion-create/REFERENCE.md index 7e56bb3..0ffa994 100644 --- a/skills/remotion-best-practices/remotion-create/REFERENCE.md +++ b/skills/remotion-best-practices/remotion-create/REFERENCE.md @@ -1,7 +1,7 @@ --- name: remotion-create description: Create a new Remotion video -version: 4.0.526 +version: 4.0.528 --- These are instructions for making a new Remotion project and composition. diff --git a/skills/remotion-best-practices/remotion-docs/REFERENCE.md b/skills/remotion-best-practices/remotion-docs/REFERENCE.md index 0167029..b27a0c5 100644 --- a/skills/remotion-best-practices/remotion-docs/REFERENCE.md +++ b/skills/remotion-best-practices/remotion-docs/REFERENCE.md @@ -1,7 +1,7 @@ --- name: remotion-docs description: Search Remotion documentation -version: 4.0.526 +version: 4.0.528 --- This skill teaches you how to discover and read current Remotion documentation. diff --git a/skills/remotion-best-practices/remotion-interactivity/REFERENCE.md b/skills/remotion-best-practices/remotion-interactivity/REFERENCE.md index 9901aba..f95a8c1 100644 --- a/skills/remotion-best-practices/remotion-interactivity/REFERENCE.md +++ b/skills/remotion-best-practices/remotion-interactivity/REFERENCE.md @@ -1,7 +1,7 @@ --- name: remotion-interactivity description: Structure Remotion markup for interactivity -version: 4.0.526 +version: 4.0.528 --- By writing Remotion markup in a specific way, the Remotion Studio is able to recognize the structure of the code and makes it interactive: diff --git a/skills/remotion-best-practices/remotion-maps/REFERENCE.md b/skills/remotion-best-practices/remotion-maps/REFERENCE.md index 6ce8b2c..d6907a8 100644 --- a/skills/remotion-best-practices/remotion-maps/REFERENCE.md +++ b/skills/remotion-best-practices/remotion-maps/REFERENCE.md @@ -1,7 +1,7 @@ --- name: remotion-maps description: Remotion Map animation knowledge -version: 4.0.526 +version: 4.0.528 --- # Remotion Maps diff --git a/skills/remotion-best-practices/remotion-markup/REFERENCE.md b/skills/remotion-best-practices/remotion-markup/REFERENCE.md index c05f131..a942136 100644 --- a/skills/remotion-best-practices/remotion-markup/REFERENCE.md +++ b/skills/remotion-best-practices/remotion-markup/REFERENCE.md @@ -1,7 +1,7 @@ --- name: remotion-markup description: Content, animation and effects best practices -version: 4.0.526 +version: 4.0.528 --- This is guidance for writing Remotion React Markup. @@ -222,6 +222,10 @@ See [text-highlights.md](text-highlights.md) for text highlights (highlight mark See [multi-scene-video.md](multi-scene-video.md) if planning to make a video with multiple subsequent scenes. +## Connected compositions + +When a scene or group of layers deserves its own editable timeline, follow [connected-compositions.md](connected-compositions.md). Prefer this structure for substantial scenes in a multi-scene video. + ## Voiceover See [voiceover.md](voiceover.md) for adding an AI-generated voiceover to Remotion compositions using ElevenLabs TTS. @@ -327,7 +331,7 @@ See [calculate-metadata.md](calculate-metadata.md) for dynamically set compositi ## Advanced compositions -See [compositions.md](compositions.md) for how to define stills, folders, default props and for how to nest compositions. +See [compositions.md](compositions.md) for how to define stills, folders, default props and for how to nest compositions. For Studio navigation into a scene's own timeline, use [connected compositions](connected-compositions.md). ## Advanced sequencing @@ -343,23 +347,8 @@ npx remotion add @remotion/media This goes for `@remotion/*` packages, `mediabunny`, `@mediabunny/*`, `zod`, and `@huggingface/transformers`. -## Previewing markup - -``` -npx remotion studio --no-open -``` +## Visual checks -This will start a long-running process and print the server URL for the preview. -If server is already started, it will print the URL. -You can visit a specific composition by navigating to `/[composition-id]`, for example `http://localhost:3000/MapAnimation`. - -## Optional: one-frame render check - -You can render a single frame with the CLI to sanity-check layout, colors, or timing. -Skip it for trivial edits, pure refactors, or when you already have enough confidence from Studio or prior renders. - -```bash -npx remotion still [composition-id] --scale=0.25 --frame=30 -``` +When a visual check is useful, open the [Remotion Studio](../remotion-studio/REFERENCE.md) for an interactive preview. -At 30 fps, `--frame=30` is the one-second mark (`--frame` is zero-based). +You can also use [Rendering](../remotion-render/REFERENCE.md) to inspect one or several frames as images. diff --git a/skills/remotion-best-practices/remotion-markup/audio.md b/skills/remotion-best-practices/remotion-markup/audio.md index ad917a4..3a31e8f 100644 --- a/skills/remotion-best-practices/remotion-markup/audio.md +++ b/skills/remotion-best-practices/remotion-markup/audio.md @@ -58,18 +58,16 @@ The audio still starts playing at the beginning of the composition - only the sp ## Delaying -Wrap the audio in a `` to delay when it starts: +Set `from` directly on `