StewdioAI/blank-page

项目介绍

blank-page 是给 Claude Code、Codex 等编程 Agent 用的技能，用来把模糊的动效创意扩写成可直接交给生成模型的完整提示词。它针对的是「空白页」问题：一句话的提示给 Agent 的约束太少，结果往往退回到最安全、最普通的版本。这个技能不让人填空，而是先去找视觉与运动参考，再围绕参考组织提示词，并附上真实素材，最后返回扩写后的提示词 README lines 3–20。

它适合做短片动效的人——发布视频、社交贴文、网站背景等，知道自己要什么用途但不确定视觉方向，或者想探索自己没想到的方向。作者是 Blake Shao，项目与 Stewdio 相关，后者是一个用提示词创作并在可视化编辑器中手工打磨动效的平台 Stewdio。

快速使用

用 skills CLI 安装，在仓库根目录或任意工作目录执行：

npx skills add StewdioAI/blank-page

安装过程会询问为哪些编程 Agent 安装；加 -g 可安装到所有项目而非仅当前项目 Install。

然后在 Claude Code 里用 /blank-page（Codex 里用 $blank-page）像说话一样描述镜头：

/blank-page a 5 second launch video for my app

也可以补充用途、氛围或喜欢的品牌，或者说「expand this prompt」「help me write the prompt for ...」来触发 How to use。返回结果是一份附有参考素材的完整提示词，外加最多三个创意决策，你可以在交给 Agent 前替换其中任意一个。

README 的 before/after 用同一句提示分别直接运行和先经 /blank-page 处理，并排展示生成的片段 before/after 示例。更多示例见 references/examples.md。

工作原理

技能按四步流程执行 How it works：

1. 确定视觉：在 are.na、Pinterest 或开放网络上找同一审美方向的五张图；如果指定了风格或品牌，搜索会限制在该范围内。
2. 找运动参考：找三个可参考运动方式的 gif 或视频。
3. 写分镜节奏：基于参考写出带编号的序列，至少包含一个转折，例如揭示、变形或拉远。
4. 加入真实素材：用 3D 模型、实拍素材或真实 UI，代替手工搭建的替代品。

短修改指令（如「make it faster」）会跳过搜索，返回一条简短的精确说明。仓库结构中，流程写在 SKILL.md，搜索、下载和拼图脚本在 scripts/，参考资料在 references/ Layout。

使用约束

• 参考脚本需要 python3（仅标准库）和 curl。
• 只有生成拼图（find_refs.py sheet、channel <slug> <dir>）时才需要 ffmpeg。
• 查找 Pinterest 图片依赖 Agent 具备网页搜索能力。
• SKETCHFAB_TOKEN 是可选的，仅在 Sketchfab 素材不在 Objaverse 镜像中时需要 Requirements。
• 技能声称可与任意编程 Agent 配合，但 README 具体记录了 Claude Code 和 Codex 的调用方式。
• 参考搜索会从外部网站拉取图片、gif 和模型，这些素材的可用性与授权由来源网站决定，不归本项目管；仓库本身是 MIT 许可 LICENSE。

HotRepo 点评

项目很新、规模很小，站内记录也有限。它在 2026-11-05 进入 HotRepo 的 Python 新项目榜，当时 108 Star、2 Fork，在一个约一小时的统计窗口内净增 7 Star，尚未记录到全语言日榜名次 repository。这一次快照只能说明早期获得了一些关注，不足以判断趋势或采用程度。更有参考价值的是它的设计：这是一个可检查的具体 Agent 技能（流程、脚本和参考素材都在仓库里），而不是某个托管服务的包装，README 也用同一模型在有无该技能时的前后对比展示了输出差异。