Back to search
promo-creator-skills
SkillGitHub
产品宣传视频创作 Skills:从产品判断、分镜、素材、HyperFrames 剪辑到 BGM 设计的完整 Agent 工作流
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/kangarooking--promo-creator-skills)HTML
<a href="/listings/kangarooking--promo-creator-skills"><img src="/api/listings/kangarooking--promo-creator-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 170 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: promo-creator-skills
- description: 产品宣传片制作总控 skill pack。用于从产品说明、官网、应用截图或 GitHub 仓库制作 60-90 秒宣传视频,按阶段完成 brief、storyboard、素材、HyperFrames 剪辑、BGM 设计和交付。当用户要做宣传片、产品视频、项目介绍视频、launch video、开源项目 promo、BGM 卡点或真实软件界面宣传片时使用。
- description_zh: "产品宣传片全流程制作,涵盖简报、分镜、素材、剪辑、配乐到交付"
- description_en: "End-to-end product promo video creation: brief, storyboard, assets, editing, BGM, and delivery"
- ---
- # Promo Creator Skills
- 这是产品宣传片创作的总控入口。它必须能独立指导完整项目;子 skill 是阶段深水区,不是唯一的流程来源。
- 默认目标:用真实产品信息、真实软件界面和可验证素材,制作一支 60-90 秒、可发布的产品宣传片 MP4。不要把它当成氛围视频、图片轮播或泛科技动效练习。
- ## 总控判断
- 当用户只说“做宣传片 / 产品视频 / launch video / promo”时,默认走完整流程:
- ```text
- 产品信息或 URL
- -> 01-brief.md
- -> 02-storyboard.md
- -> 03-asset-plan.md + assets/
- -> 04-edl.md + master-edit.html
- -> 06-music-plan.md + assets/bgm/
- -> final/promo.mp4 或 final/promo-with-bgm.mp4
- -> 05-delivery.md
- ```
- 当用户明确只要某一段能力时,只执行对应阶段。例如“只要 BGM prompt”只用音乐阶段;“我已经有素材,直接剪辑”从 EDL 和 HyperFrames 阶段开始。
- ## 子 Skill 路由
- 优先按总控流程推进;进入某个阶段时,读取对应子 skill 的 `SKILL.md` 获取详细规范。
- | 用户目标 | 详细规范 |
- |---|---|
- | 从零做完整宣传片 | `promo-workflow/SKILL.md` |
- | 只做产品分析和创意简报 | `promo-brief/SKILL.md` |
- | 已有 brief,要写分镜 | `promo-storyboard/SKILL.md` |
- | 已有分镜,要准备素材 | `promo-asset-producer/SKILL.md` |
- | 已有素材,要剪辑渲染 | `promo-editor/SKILL.md` |
- | 要配乐、BGM、卡点音乐 prompt | `promo-music-maker/SKILL.md` |
- ## 阶段流程
- ### Phase 1: Brief
- 详细规范见 `promo-brief/SKILL.md`。输入可以是产品说明、官网、GitHub 仓库、应用截图、用户口述或竞品链接。
- 产出 `01-brief.md`:
- - 产品定位和目标观众
- - 核心卖点和证明点
- - 推荐视觉风格
- - 叙事结构和时长建议
- - 风险、素材缺口和需要用户确认的问题
- 暂停点:确认定位、风格、时长、主叙事。
- ### Phase 2: Storyboard
- 详细规范见 `promo-storyboard/SKILL.md`。不要在 brief 未确认前直接写完整剪辑。
- 产出 `02-storyboard.md`:
- - 逐镜头时间码
- - 每个镜头的画面、文案、动效、转场、素材需求
- - 真实 UI / 真实产品信号应该出现在哪些镜头
- - HyperFrames 实现提示
- 暂停点:确认镜头内容、节奏、文案密度和转场方向。
- ### Phase 3: Assets
- 详细规范见 `promo-asset-producer/SKILL.md`。优先真实产品素材,其次生成补充视觉。
- 产出:
- - `03-asset-plan.md`
- - `assets/pack-a/`:AI 生成或补充视觉
- - `assets/pack-b/`:官网、截图、开源项目、文档或其他可验证素材
- - `assets/pack-b/pack-b-sources.md`:来源记录
- 暂停点:确认素材质量和版权/来源可接受性。
- ### Phase 4: Edit
- 详细规范见 `promo-editor/SKILL.md`。用 HyperFrames/HTML/CSS/GSAP 构建可渲染视频,不只给剪辑建议。
- 产出:
- - `04-edl.md`
- - `master-edit.html`
- - `final/promo.mp4`
- 暂停点:确认成片结构、画面密度、节奏和需要返修的镜头。
- ### Phase 5: Music
- 详细规范见 `promo-music-maker/SKILL.md`。音乐必须服务剪辑节奏,不要默认生成 ambient 科技垫底音乐。
- 产出 `06-music-plan.md`:
- - 音乐风格、BPM、情绪曲线
- - 和镜头转场对齐的 hit points
- - Mureka / Skywork Music Maker 英文 prompt
- - negative prompt
- - 至少 2 个有明显差异的方向
- 用户确认或要求实际生成时,再调用脚本生成 BGM。
- ### Phase 6: Delivery
- 补齐 `05-delivery.md`:
- - 最终视频路径
- - 源文件路径
- - 素材和 BGM 清单
- - 修改方式
- - 已知限制
- ## 工作目录
- 每个项目创建独立 run 目录:
- ```text
- outputs/promo-runs/YYYY-MM-DD-<product>/
- ```
- 如果用户给了明确项目名,使用用户项目名;否则根据产品名生成短 slug。
- ## 暂停规则
- 必须暂停的节点:
- - Brief 完成后
- - Storyboard 完成后
- - 素材计划或关键素材完成后
- - BGM 方向确认前实际生成音乐
- - 最终渲染后
- 暂停时最多问 3 个问题,并给出推荐选项。用户明确说“按你推荐来 / 继续 / ok”时,按推荐方案推进,不要反复追问。
- ## 执行约束
- - 先做产品判断,再做画面。
- - 先写分镜,再批量生成素材。
- - 先确认音乐方向,再消耗音乐生成额度。
- - 真实软件界面优先于抽象装饰图。
- - 所有外部素材记录来源。
- - 不要把多个根 HyperFrames composition 留在同一渲染目录。
- - 如果图片、浏览器、音乐或渲染能力不可用,输出可执行 prompt、素材清单或命令,并明确缺口。
- ## BGM 默认策略
- 产品宣传片默认先给两个差异明显的方向:
- | 方向 | 用途 |
- |---|---|
- | `Commercial Product Launch` | 产品发布、商业展示、CTA 更强的广告片 |
- | `Clean UI Demo Groove` | 真实软件界面、SaaS、流程展示、UI demo |
- 候选之间必须在 genre、rhythm、bass、hook、energy curve 上形成明显差异。避免多个 prompt 都写成 `minimal / ambient / soft pulse / glass ticks`。
- 详细音乐规范见 `promo-music-maker/SKILL.md` 和 `references/product_promo_bgm_prompting.md`。
- ## 最小可执行流程
- 当只能读取本文件时,也按下面步骤工作:
- 1. 根据用户输入创建 run 目录。
- 2. 写 `01-brief.md`,暂停确认。
- 3. 写 `02-storyboard.md`,暂停确认。
- 4. 写 `03-asset-plan.md`,收集或生成素材,暂停确认。
- 5. 写 `04-edl.md` 和 `master-edit.html`,渲染 `final/promo.mp4`。
- 6. 写 `06-music-plan.md`,确认后生成或匹配 BGM。
- 7. 合成 `final/promo-with-bgm.mp4`,写 `05-delivery.md`。
README.md · README · 193 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Promo Creator Skills
- [English](README.en.md) · 中文
- > 一套面向真实产品宣传片的 production-grade Skills:产品判断、叙事结构、视觉规划、HyperFrames 剪辑、BGM 设计和交付清单,全链路跑通。
- 大多数 AI 宣传片失败,不是因为动效不够多,而是因为一开始就跳过了产品判断。它们先做画面,再临时找理由;先堆光效,再假装有叙事。最后出来的东西看起来“像视频”,但不像一个真正懂产品的人会拿出去发布的片子。
- Promo Creator Skills 反过来做。它把一支宣传片拆成一组严肃的生产决策:这个产品到底是什么,为什么值得看,观众第一眼应该理解什么,哪些真实素材能证明它,每个镜头如何推进信息,音乐如何托住剪辑节奏。它不是魔法按钮,而是一套让 agent 按专业制作流程工作的技能系统。
- 适合的目标不是“做得炫一点”,而是:**在 60-90 秒内,把产品讲清楚、讲可信,并让人愿意继续了解。**
- ```bash
- npx skills add kangarooking/promo-creator-skills
- ```
- 如果你的 skill runner 不支持 `npx skills add`,可以手动把 `promo-*` 文件夹复制到你的 agent skills 目录。
- ---
- ## 案例展示
- ### WorkBuddy OPC · Commercial Product Launch
- 更像现代产品发布广告片:有 beat、bass、hook 和 CTA 推进感。适合产品上架、新能力发布、商业展示。
- [在 Bilibili 实时播放](https://www.bilibili.com/video/BV11h5t6dELW/)
- ### WorkBuddy OPC · Clean UI Demo Groove
- 更像高级软件 UI 演示片:节奏干净,服务界面、卡片矩阵、流程线和时间线卡点。
- [在 Bilibili 实时播放](https://www.bilibili.com/video/BV1m45t6bEFM/)
- ### Cangjie Skill · 开源项目宣传片
- 一支 90 秒瑞士国际主义风开源项目宣传片。Cangjie Skill 的价值不在于“又一个读书总结工具”,而在于把高价值书籍的方法论编译成 Agent 可以调用的触发条件、执行步骤、边界和测试。好的开源项目不是把 README 录一遍,而是把它真正值得被记住的系统讲清楚。
- [在 Bilibili 实时播放](https://www.bilibili.com/video/BV1LS5t6CESM/)
- > GitHub README 会清洗外部播放器 iframe,不能直接内嵌 B 站播放器;点击链接可在 Bilibili 实时播放。
- ---
- ## 它能做什么
- 这套 Skills 的基本判断是:**好的产品宣传片,本质是一段被压缩过的产品论证。** 画面、动效、音乐都应该服务这个论证,而不是掩盖产品表达的空心。
- | Skill | 职责 | 产物 |
- |---|---|---|
- | `promo-brief` | 产品研究、卖点提炼、叙事定位 | `01-brief.md` |
- | `promo-storyboard` | 逐镜头分镜、画面、文案、动效说明 | `02-storyboard.md` |
- | `promo-asset-producer` | 生成素材与真实产品素材规划 | `03-asset-plan.md`, `assets/` |
- | `promo-editor` | HyperFrames 剪辑、动效、渲染 | `04-edl.md`, `master-edit.html`, `final/promo.mp4` |
- | `promo-music-maker` | BGM 方向、卡点表、Mureka Prompt | `06-music-plan.md`, `assets/bgm/` |
- | `promo-workflow` | 串联完整制作流程 | 可交付 run 目录 |
- 整套流程不是一发入魂,而是把宣传片拆成可检查、可修改、可复用的阶段:
- ```text
- 产品 / 仓库 / URL
- -> 创意简报
- -> 逐镜头分镜
- -> 素材计划
- -> 编辑决策表
- -> HyperFrames 主剪辑
- -> BGM 方向和候选
- -> 最终 MP4
- -> 交付清单
- ```
- 每个阶段都会留下文件,所以你可以在真正昂贵的步骤之前纠偏:渲染之前改分镜,生图之前改素材计划,烧音乐额度之前改 BGM 方向。
- ---
- ## 为什么它不只是 Prompt 合集
- - **先做产品判断**:brief 阶段先确定受众、定位、叙事结构和证明点,再进入视觉。
- - **写的是镜头,不是氛围词**:storyboard 会拆到构图、字号、时间、动效、素材需求。
- - **真实产品信号优先**:截图、文档、GitHub 数据、界面细节,比 AI 装饰图更有价值。
- - **BGM 属于剪辑,不是背景噪音**:音乐 prompt 明确 genre、rhythm、bass、hook、energy curve 和 hit points。
- - **过程可检查**:每一步都有 Markdown 或源文件,方便复盘、修改和复用。
- ---
- ## BGM:不再生成那种“泛科技垫底音乐”
- 这次专门把 BGM 设计升级了:**Apple 风画面不等于 ambient BGM**。产品宣传片需要节奏、hook、bass movement 和段落变化。
- 软件产品宣传片默认先走两条已验证方向:
- - **Commercial Product Launch**:118 BPM,电子鼓、sidechain bass、明亮 pluck hook,更像产品发布广告片。
- - **Clean UI Demo Groove**:112 BPM,syncopated digital percussion、rubbery synth bass、短促 glass-pluck motif,更像高级 UI 演示片。
- 这样不会再出现多个候选都像 `minimal / ambient / soft pulse / glass ticks` 的问题。
- Mureka 生成脚本:
- ```bash
- export MUREKA_API_KEY="..."
- export MUREKA_API_URL="https://api.mureka.cn" # 国内站可选
- python scripts/mureka.py instrumental \
- --prompt "<validated product-promo BGM prompt>" \
- -n 2 \
- --format mp3 \
- --output outputs/promo-runs/<run-id>/assets/bgm/
- ```
- 没有 API key 也可以使用这个 skill 设计 BGM prompt;只有用户明确要求实际生成音乐时才调用 Mureka。
- ---
- ## 使用方式
- 对 agent 说:
- ```text
- 用 promo-workflow 给这个 GitHub 仓库做一支 60 秒 Apple 风产品宣传片:
- https://github.com/owner/project
- ```
- 或者:
- ```text
- 用这套 promo skills 给我的 SaaS 做发布视频。先出 brief 和 storyboard,我确认后再继续。
- ```
- 如果你已经有素材:
- ```text
- 直接用 promo-editor 和 promo-music-maker。我已经有分镜和截图。
- ```
- ---
- ## 仓库结构
- ```text
- promo-creator-skills/
- ├── README.md # 中文默认介绍
- ├── README.en.md # English README
- ├── SKILL.md # skill pack 入口
- ├── promo-brief/ # 产品研究与创意简报
- ├── promo-storyboard/ # 逐镜头分镜
- ├── promo-asset-producer/ # 素材生产与素材计划
- ├── promo-editor/ # HyperFrames 剪辑与渲染
- ├── promo-music-maker/ # BGM Prompt 与 Mureka 工作流
- ├── promo-workflow/ # 总控流程
- ├── references/
- │ ├── mureka_prompt_guide.md
- │ └── product_promo_bgm_prompting.md
- └── scripts/
- └── mureka.py
- ```
- 仓库根目录的 `SKILL.md` 是完整总控入口:只读它也能跑通主流程;各个 `promo-*` 子 skill 保留更细的阶段规范,方便单独调用和深度执行。
- ---
- ## 环境依赖
- - Node.js 22+
- - HyperFrames CLI
- - FFmpeg
- - Python 3.10+
- - `requests` Python 包
- - 可选:`MUREKA_API_KEY`,用于实际生成 BGM
- ---
- ## 设计原则
- - **中间文件优先**:每个关键决策先落 Markdown,再进入渲染。
- - **真实产品信号优先**:UI 截图、文档、GitHub 数据、品牌素材,优先级高于装饰图。
- - **先分镜,后素材**:没有 shot plan 的生图只是烧钱随机数。
- - **音乐必须服务画面**:产品片需要 rhythm、hook、bass 和 section contrast。
- - **暂停点就是质量控制**:在贵的步骤之前,让用户有机会纠偏。
- ---
- ## 边界
- - 这是 skill pack,不是托管视频编辑器。
- - 最终质量取决于产品素材质量和本地渲染环境。
- - Mureka 生成有随机性,建议一次生成 2-3 条,放回视频里看,而不是单独听音频决定。
- - 本地完整生产过程放在 `outputs/`,默认不进 git;公开案例建议上传到视频平台后在 README 引用。
- ---
- ## License
- MIT.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.