framesmith 是一套面向 AI 智能体的动态图形、视频与视觉设计技能库。每个模板本身就是一项技能，通常由 SKILL.md、需求简报的 schema、附带素材的示例简报，以及一个 scripts/ 命令行入口组成；渲染时使用共享引擎：numpy + Pillow 生成帧，再交给 ffmpeg 合成。该工具不需要浏览器、GPU 或账号；图像生成（gpt-image-2）是可选能力，没有密钥时会使用占位素材。
用途与模板选择：入口文档建议先按需求路由到对应模板。video-to-template 用于用户提供参考视频、希望“做一个类似的”或“复制这个风格”的场景，覆盖分析→分镜→动态分镜→素材→构建→对比→交付的完整流程。brutalist-product-promo 输出约 22.6 秒的 9:16 MP4、21 个场景，适合硬件或科技产品宣传、规格表动态图形、工业/粗野主义风格。devtool-launch-video 输出约 33.8 秒的 16:9 MP4、11 个场景，面向 CLI、开发工具、AI 智能体或安全产品的发布或“X 是什么”短片。narrated-collage-explainer 输出约 50 秒的 1:1 MP4，带旁白，采用纸白拼贴风格，按口播提示点推进。brand-icons 输出 SVG + PNG 品牌标识，并附许可与署名表，用于“兼容/合作”标识墙等设计需求。keynote-product-film 输出约 60–90 秒的 16:9 MP4，音乐驱动、无旁白，走苹果发布会风格。no-ai-slop 用于在渲染前检查脚本、字幕和屏幕文字，也适用于识别 AI 味明显的文稿。其余模板包括 glass-saas-promo（约 30–40 秒、16:9、音乐驱动的磨砂玻璃风格 SaaS 推广）、blue-story-film（约 60–90 秒、16:9、蓝光风格故事片）、illustrated-explainer（约 60–100 秒、16:9、带旁白的扁平矢量企业解说）、animated-character-explainer（约 45–90 秒、16:9、带旁白、基于一致透明 PNG 角色的动画解说）、archive-launch-film（约 60–90 秒、16:9、带旁白、纪录片冷开场转品牌揭示）、kinetic-launch-film（约 60–90 秒、16:9、带旁白与合成音效、文字主导的发布片）、abstract-journey-film（约 80 秒、16:9、纯音乐合成配乐、会议开场或品牌片头）、cartoon-launch-film（约 45 秒、方形 1080、纯音乐与卡通音效、手绘沸腾风格社交发布片）。如果都不匹配，入口文档建议明确说明，并提议新建模板，而不是勉强套用。
使用方式：每个模板暴露相同的 CLI 动词，例如：
python3 skills/<name>/scripts/<entry>.py check --brief brief.json # validate python3 skills/<name>/scripts/<entry>.py assets --brief brief.json # gpt-image-2, low/medium quality python3 skills/<name>/scripts/<entry>.py still --brief brief.json 3.4 9.1 python3 skills/<name>/scripts/<entry>.py sheet --brief brief.json # contact sheet python3 skills/<name>/scripts/<entry>.py render --brief brief.json [--audio a.mp3]
文档强调在完整渲染前先检查静帧或联系表，并报告哪些素材是占位素材。
新建模板：使用 video-to-template，其中包含参考分析（analyze.py）、带时间轴的动态分镜脚手架（scaffold.py）、并排对比（compare.py）、设计规则，以及一份“每条都导致过一次重渲染”的常见问题清单。没有参考视频时，可用 python3 tools/new_skill.py <name> 脚手架一个空白模板，并从第 2 阶段开始遵循同样的流程。
适用场景与限制：适合需要可复现、脚本化生成动态图形与短视频的 AI 智能体工作流，覆盖产品发布、解说、品牌标识与风格复刻等。限制方面，图像生成依赖可选的 gpt-image-2 密钥，否则使用占位素材；文档未提供价格、平台兼容性、渲染性能或画质保证等信息，暂未提供。