Skip to content

kangarooking/promo-creator-skills

Repository files navigation

Promo Creator Skills

English · 中文

一套面向真实产品宣传片的 production-grade Skills:产品判断、叙事结构、视觉规划、HyperFrames 剪辑、BGM 设计和交付清单,全链路跑通。

大多数 AI 宣传片失败,不是因为动效不够多,而是因为一开始就跳过了产品判断。它们先做画面,再临时找理由;先堆光效,再假装有叙事。最后出来的东西看起来“像视频”,但不像一个真正懂产品的人会拿出去发布的片子。

Promo Creator Skills 反过来做。它把一支宣传片拆成一组严肃的生产决策:这个产品到底是什么,为什么值得看,观众第一眼应该理解什么,哪些真实素材能证明它,每个镜头如何推进信息,音乐如何托住剪辑节奏。它不是魔法按钮,而是一套让 agent 按专业制作流程工作的技能系统。

适合的目标不是“做得炫一点”,而是:在 60-90 秒内,把产品讲清楚、讲可信,并让人愿意继续了解。

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 实时播放

WorkBuddy OPC · Clean UI Demo Groove

更像高级软件 UI 演示片:节奏干净,服务界面、卡片矩阵、流程线和时间线卡点。

在 Bilibili 实时播放

Cangjie Skill · 开源项目宣传片

一支 90 秒瑞士国际主义风开源项目宣传片。Cangjie Skill 的价值不在于“又一个读书总结工具”,而在于把高价值书籍的方法论编译成 Agent 可以调用的触发条件、执行步骤、边界和测试。好的开源项目不是把 README 录一遍,而是把它真正值得被记住的系统讲清楚。

在 Bilibili 实时播放

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 目录

整套流程不是一发入魂,而是把宣传片拆成可检查、可修改、可复用的阶段:

产品 / 仓库 / 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 生成脚本:

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 说:

用 promo-workflow 给这个 GitHub 仓库做一支 60 秒 Apple 风产品宣传片:
https://github.com/owner/project

或者:

用这套 promo skills 给我的 SaaS 做发布视频。先出 brief 和 storyboard,我确认后再继续。

如果你已经有素材:

直接用 promo-editor 和 promo-music-maker。我已经有分镜和截图。

仓库结构

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.

About

产品宣传视频创作 Skills:从产品判断、分镜、素材、HyperFrames 剪辑到 BGM 设计的完整 Agent 工作流

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages