Communitygithub.com

Hasnan42/Showfolio

将当前的 Octacer 项目转化为一个精美的、带有 Octacer 品牌标识的展示视频(约 40、60 或 90 秒),使用 Hyperframes 实现。项目本身的真实界面保持不变,而周围的所有元素(片头、标题、背景、片尾、动画 Logo)均使用 Octacer 品牌风格。

Showfolio 是什么?

Showfolio 是一个 AI 辅助工具技能,专门用于将开发者已构建的 Octacer 项目(网站或应用)自动生成为一个 polished 且可分享的展示视频。它通过 Hyperframes 技术,在保留项目真实界面的同时,为其套上 Octacer 品牌框架,包括动态 Logo 片头、标题、背景、标签和角落 Logo。该技能支持三种视频时长(约 40、60、90 秒),并允许用户自定义要展示的功能页面、视频色调(内置 7 种预设,如 polished、cinematic、app-store 等)、格式(横屏/竖屏/方形)以及是否开启画外音。用户只需提供简单的输入(如“/showfolio”或“make a showcase video”),Showfolio 就会自动读取项目代码,规划故事板,生成视频渲染文件,并编写分享文案。它特别适合需要在社交媒体或产品演示中快速创建高质量项目宣传视频的开发者。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Hasnan42/Showfolio/tree/HEAD/skills/showfolio

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

/showfolio

你构建了它。现在展示它。

调用分发(必须首先执行)

模型检查。 如果你是 Claude Opus 5.5 并且调用不要求完整工作流(--full,“使用完整的 showfolio”)或画外音(--voice,showfolio-slim 不支持),则切换到 showfolio-slim:读取 <skill-dir>/slim.md(/showfolio-slim 技能,已捆绑在此)并按照它执行本次运行,而不是本文件。将用户的输入传递给它,并将任何其他选项(--no-music、--title、……)作为自然语言方向传递。首先用一行通知用户,例如:“你正在使用 Opus 5.5,因此我将使用 /showfolio-slim:我会独立构建整个视频。说‘使用完整的 showfolio’可切换回来。”如果你是任何其他模型,或无法确定自己的模型,则跳过此检查。

在检查项目之前,解析完整的 /showfolio 调用。如果调用包含 --voice,则将 voice.enabled 设置为 true。仅对该次运行启用旁白。不要自动启用旁白,也不要退回到标准的无声工作流。

/showfolio 将当前的项目网站或应用转换为一个精美、可分享的展示视频,使用 Hyperframes,并以 Octacer 构建的项目形式呈现。它专注、有主见且有趣。

Octacer 品牌始终开启。 项目本身的界面完全按照原样显示,而围绕它们的框架(动态 Logo 片头、标题、背景、标签、角落 Logo、片尾)是 Octacer 风格。规则和资产:references/brand.md 和 <skill-dir>/assets/brand/。

此技能的功能

  1. 向用户提出三个引导性问题(时长、要展示的内容、目的),如果应用需要登录则获取测试凭据。
  2. 读取当前项目代码以理解应用。
  3. 规划针对此项目的展示概念。
  4. 在 Octacer 品牌框架内编写视频脚本和故事板。
  5. 向 Hyperframes 提交一个聚焦的合成简报。
  6. 验证、渲染并编写分享文案。

解析调用

用户可以使用自然语言或标志进行调用:

/showfolio
/showfolio --duration 60
/showfolio --tone polished --format vertical
/showfolio this. Make it feel like a premium product film.

解析这些选项:

选项值默认值
--tone预设或自由格式描述推断
--formatlandscape、vertical、squarelandscape
--duration秒(约 40、60 或 90)在第 0 步询问
--no-music标志音乐开启
--no-sfx标志音效开启
--title字符串从项目推断
--voice标志旁白关闭

画外音是选择加入的。如果存在 --voice,则通过 Hyperframes 使用 Kokoro,并且不要添加任何提供商选择逻辑。画外音工作流有意设计为单一提供商。

色调可以是预设(default、polished、yc-parody、chaotic、deadpan、cinematic、app-store),也可以是创意方向,例如“fake Series A launch from 2016”、“museum exhibit”或“overproduced mobile game ad”。

当用户给出自由格式的色调方向时,将其映射到最接近的预设以确定节奏和结构,但在计划和合成简报中保留用户的方向。

旁白指导

当启用 --voice 时,编写的旁白应:补充视觉内容,不只是读出可见文本,与场景节奏匹配,听起来自然且对话式,并在场景之间平滑过渡。保持脚本简洁且针对产品,使画外音感觉像是剪辑的一部分,而不是独立的旁白轨道。


输出目录

默认情况下,输出到 showfolio-output/。为避免覆盖之前的运行,请使用带时间戳的目录:

showfolio-output-2026-05-04-143022/

在以下情况下使用时间戳:

  • 用户明确要求新运行而不覆盖之前的结果
  • 项目中已存在 showfolio-output/ 目录

在运行开始时生成时间戳(YYYY-MM-DD-HHmmss)并在该运行的所有输出路径中一致使用:计划、简报、合成、渲染和分享文案。

技能目录

<skill-dir> 是包含此 SKILL.md 的目录。Claude Code 在技能加载时会将其打印为“此技能的基础目录”;对于其他代理,它取决于技能的安装位置。捆绑的资产位于 <skill-dir>/assets/,脚本位于 <skill-dir>/scripts/。不要猜测安装路径:插件安装、~/.claude/skills/ 副本以及此仓库都会将其放在不同的位置。


第 0 步:引导

读取: references/step-0-intake.md

在一条消息中向用户提出三个引导性问题(视频时长、要展示的功能/页面、一行目的)并等待回答。然后执行登录检查:如果要展示的部分位于登录后面,则使用用户提供的凭据,否则在仓库中查找测试凭据,否则向用户索要。

关口: 你有了目标时长、必展示列表(带有用户标记的最爱项)和一行目的。如果应用需要登录,你有了可用的测试凭据,或者用户已表示无需凭据继续。


第 1 步:检查项目

读取: references/step-1-inspect.md

扫描项目目录并提取规划视频所需的信息。特别关注用户在第 0 步中选择的功能和页面。

关口: 你能回答规划评估表中的所有 9 个问题。


第 2 步:规划和故事板

读取: references/step-2-plan.md 读取: references/brand.md

编写 <output-dir>/showfolio-plan.md(其中 <output-dir> 是上面选择的 showfolio-output/ 或带时间戳的变体)。回答规划评估表。确定创意角度。编写节拍式的故事板,包括场景、文本、时间、转场和音效提示。

当选择音乐时,包含一个紧凑的“音乐提示指导”部分:读取捆绑曲目中 <skill-dir>/assets/music/cues/ 的提示预设(如果存在),否则注明提示将在合成时检测(任何曲目现在都支持节拍同步——请参阅 references/audio.md)。提示元数据仅为可选的时间指导:故事、可读性、节奏和产品清晰度保持首要地位。

关口: <output-dir>/showfolio-plan.md 存在且包含完整的故事板。第 0 步中的每个必展示项都有一个场景。场景时长之和与第 0 步的目标时长相差不超过 ±10%。


第 3 步:移交给 Hyperframes

读取: Hyperframes 领域技能——hyperframes-core、hyperframes-animation、hyperframes-creative、hyperframes-keyframes、hyperframes-cli。/showfolio 是其自己的工作流:不要进入 hyperframes 入口点意图访谈或路由到其通用的宣传/发布视频工作流。 读取: references/step-3-compose.md 读取: references/audio.md 读取: references/brand.md

将 <skill-dir>/assets/brand/ 复制到合成的资产中。编写合成简报并使用 Hyperframes 在 <output-dir>/composition/ 中创建视频实现。

/showfolio 拥有产品角度、源材料、故事板、色调、格式、音频选择、音乐提示指导和交付预期。Hyperframes 拥有具体的合成结构、精确的动画时序、动画机制、运行时选择、lint 规则和渲染工作流。

关口: npx hyperframes check 在 <output-dir>/composition/ 内通过且零错误(渲染前的单个浏览器关口——请参阅 hyperframes-cli 了解其审计内容)。


第 4 步:验证、渲染和交付

读取: references/step-4-deliver.md

验证、预览,渲染至 <output-dir>/showfolio.mp4,挑选最佳海报帧到 <output-dir>/showfolio.jpg,将该海报帧烘焙为视频的第 0 帧,使其成为所有位置的空闲缩略图,并编写 <output-dir>/share-copy.txt。

关口: <output-dir>/showfolio.mp4 存在。最佳帧海报 <output-dir>/showfolio.jpg 已被挑选(不是任意帧)并烘焙为 showfolio.mp4 的第 0 帧。分享文案已编写。任何输出文件或帧中均未出现凭据。


色调系统

/showfolio 内置七种色调预设。每种都会改变脚本能量、节奏、排版个性和转场风格。预设是默认值,而非限制。

完整定义:references/tones.md

色调能量一句话描述
default俏皮、干净、可发布好心情默认值
polished严肃、优雅适用于非玩笑的项目
yc-parody面无表情的创业能量假装严肃应用于荒谬项目
chaotic快速、响亮、激进夸张且失控
deadpan冷静、干练、低调笑话就是没有笑话
cinematic戏剧性、预告片级别大动作,更大主张
app-store流畅、功能卡片般干净公司风格但不枯燥

始终允许自由格式的创意方向来完善或覆盖预设。


创意法则

这些法则适用于每个 showfolio 视频,无论色调如何。

Octacer 框架,真实产品。 产品的界面完全保持原样。它们周围的一切使用 Octacer 品牌(Ink #040408、White、Lime #A3DC2F 作为信号色;Space Grotesk、Montserrat、JetBrains Mono;Logo SVG,从不打字形式出现)。以动画 Octacer Logo 开始,以“Built by Octacer”结束。请参阅 references/brand.md。

用户要求的时长。 达到第 0 步的目标时长(约 40、60 或 90 秒),误差在 ±10% 内。用产品内容填充,而非填充物:更多功能和更长的工作应用时刻,切勿长时间停留于空白。无论是否启用旁白,此规则均适用;旁白不会延长时长窗口。

展示他们要求的功能。 用户在第 0 步中命名的每个页面或功能都有自己的场景。他们标记为最爱的功能获得最多的屏幕时间和最强的位置。

生动且快速。 60fps,0.5–0.8 秒的快速相机移动,无缓慢漂移,每 2–3 秒有新内容,大多数产品场景中鼠标点击,以及每个聊天或输入框中的实时打字。完整数字:请参阅 references/step-2-plan.md 中的“运动和节奏规则”。

可读。 通过运动和剪辑保持高节奏,绝不以闪烁文字为代价。观众必须阅读的每一行文字都应停留足够长的时间以便阅读(短标签约 0.8 秒稳定;句子约每个单词 0.3 秒)。快速进入,然后保持——切勿快速进入,然后消失。

具体。 视频必须让人感觉是为这个确切的项目制作的,而不是任何项目。用户的一行目的是故事的脊梁。

展示实物。 大多数场景显示实际 UI、文案或产品的关键视觉元素。没有抽象的填充内容。

无通用 SaaS 语言。 禁止使用“Streamline your workflow”。使用项目实际的文案和主张。

钩子是一切。 前 2 秒决定是否有人继续观看。在规划任何其他内容之前先规划钩子。

幽默需实至名归。 幽默应来自项目的荒诞性,而不是为了搞笑而搞笑。

模式:

Octacer 片头 (1.5-2.5s) → 钩子 (3-5s) → 目的/揭示 (4-8s) → 每个必展示功能一个片段 (各 6-15s;最爱的部分最长) → 片尾,带 Octacer Logo (3-5s)

进行适应。调整功能片段的尺寸,使总时长落在目标上。该模式是起始形状,而非模板。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能