Communitygithub.com

folio-visuals

规划和编写作品集所需的每张图片或短视频的提示词(英雄图、项目封面、角色表、产品图、图标、封面视频循环),适配学生拥有的工具,并保持各镜头风格一致。

folio-visuals 是什么?

folio-visuals 是一个专门为生成作品集视觉内容而设计的 AI 技能。它适用于 Claude Code 等代理工具,能自动生成一个完整的镜头列表(shot list),并为每个视觉元素撰写结构化的提示词——包括英雄图、项目封面、角色表、产品渲染图、图标和封面视频循环。该技能会根据用户的实际工具(如 ChatGPT 图片、Gemini、Higgsfield、FLUX on ComfyUI 等)自动调整提示词格式和输出策略,同时通过固定的风格行(style line)和参考图复用机制确保不同镜头之间的视觉一致性。它内置了严格的质量检查清单,要求生成的图片自然、无文字错误、符合配色方案且文件大小合适。如果用户连接了支持 MCP 的图像工具(如 Higgsfield 或 ComfyUI),技能还可以直接执行提示词;否则输出让用户手动粘贴。最终输出包括:按优先级排列的镜头表、每个镜头的九个关键要素(主体、动作、场景、光线、镜头、风格、构图、运动、避免项)组成的完整提示词、以及一份修复清单。

兼容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/vidhu12/what-the-folio-skills/tree/HEAD/skills/folio-visuals

在你喜欢的 AI 中提问

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

文档

folio-visuals 是做什么的?

真实的照片和真实的截图永远比生成的更好。只生成学生无法拍摄或截图的内容。切勿生成他们自己面部、虚假推荐照片或公司真实产品带有改动包装的图片作为真实展示。

输入

  • portfolio.json(用于英雄项目 ID)以及站点将包含的板块列表。PRD.md 由 folio-prd 稍后编写。
  • 参考图像:学生的头像、真实的产品包装、风格帧。
  • 他们拥有的工具。如果未知请询问:
    • ChatGPT 图片: 免费套餐有每日限额。适用于插图、封面、图标、基于上传参考图的编辑。可能无法返回你要求的精确形状;请请求横向构图,然后在 Canva 中裁剪到所需比例。
    • Gemini(图像): 免费套餐。擅长在保留面部的情况下编辑照片,也擅长创建一致的角色。
    • Higgsfield: 付费积分。最适合短视频和电影感镜头;可与 Claude 连接。
    • FLUX on ComfyUI: 在配备 16 GB+ 内存的 Apple Silicon Mac 上免费且本地运行。无限制尝试,私密。
    • Canva / remove.bg: 抠图、调整尺寸、样机。 免费套餐会变化;请告诉他们检查今天的限额。

第 1 步:镜头列表

制作一个表格:文件名 | 放置位置 | 类型 | 必须匹配 | 工具 | 真实或生成。 文件名遵循 assets/projects/<id>/cover.png、assets/me/... 等格式。默认需求:1 张英雄图、每个英雄项目 1 张封面、1 张 og-image(1200×630,保存为 assets/og-image.png,名称在 Canva 中键入而非生成)用于链接预览、可选的图标和 5 到 8 秒的封面循环。将列表按优先级排序。如果使用免费套餐,请说明按当前限额需要多少天。

第 2 步:每个镜头一个提示词,包含九个槽位(只有视频才需要“运动”)

主体:     谁或什么,具体描述(年龄、服装、物体、材质)
动作:     正在发生什么
场景:     在哪里,提供 2 个具体细节
光线:     方向和质量(左侧柔和的窗户光线)
镜头:     焦距、角度、景深(50mm,视线水平,浅景深)
风格:     编辑照片/扁平矢量/3D 黏土/孔版印刷;调色板使用来自 refs/cards.md 或 design-system.md 的十六进制颜色(如果两者都不存在,提出两种基色和一种强调色,在写提示词之前获得确认)
构图:     宽高比以及主体在画面中的位置(16:9,主体在右侧三分之一,左侧留白用于文字)
运动:     仅视频:摄像机移动、时长、循环(慢推进,6 秒,无缝循环)
避免:     图片中的文字、多余的手指、logo、水印、塑料感皮肤

将最终提示词写为由这些槽位组成的一个段落。对于 ComfyUI 或 FLUX,保持描述性散文风格;对于 ChatGPT 和 Gemini,当有参考图存在时,添加“使用附带的图像作为……的参考”。

配方

  • 还没有头像: 不要生成。告诉学生:手机与眼睛齐平,面对纯色墙壁,面向窗户,胸部以上,拍十张,选一张,保存为 assets/me/headshot.jpg。在经典版页面中,这张照片就是英雄图。
  • 清理你的头像: 上传真实照片。“保持面部、发型和表情完全不变。仅将背景更改为<颜色>并均匀光线。”切勿生成新的面部。
  • 角色或吉祥物表: “角色旋转展示图:同一角色的正面、3/4 侧面、侧面和背面视图,相同的服装和比例,纯<十六进制颜色>背景,每个视图带标签。”保存它,然后在之后每次拍摄该角色时始终将其作为参考图附加。
  • 产品照片: 附上真实产品包装照片。“保持包装与参考图完全一致,包括所有文字。仅更改场景:<表面>、<光线>、<道具>。”任何出错的文字:在代码中或在 Canva 中修正,不要重新生成。
  • 项目封面: 使用网站调色板的一张平静、抽象或以物体为主的图片,为标题留出空间;不要带有虚假 UI 和乱码文字。更好的做法:在设备样机中放置真实的截图。
  • 封面视频循环: 先生成静态图片并确认,然后从图像到视频:“动画化这张图片:<一个缓慢的运动>,6 秒,无缝循环,不添加新物体。”导出为 MP4(H.264),大小控制在 4 MB 以下,并附带一张海报图片。
  • 图标: “一组 6 个线条图标,2px 描边,圆角端点,<十六进制颜色>,透明背景,统一网格:<列表>。”

第 3 步:一致性

固定一个风格行(调色板的十六进制颜色、媒介、光线设置),并在每个提示词中逐字重复使用它。对任何重复出现的角色或产品,重复使用相同的参考图。每个槽位保持统一的宽高比。

第 4 步:使用前检查

针对每个输出:文字是否可读,手部和面部是否自然,是否符合调色板,是否低于 500 KB(在 squoosh.app 压缩;如果文件类型改变,例如 .png 改为 .webp,请更新 portfolio.json 中的路径以匹配),是否与其他图片看起来属于同一套?列出需要手动修复的内容。

输出

镜头列表、每个镜头的提示词、风格行以及检查清单。如果学生连接了图像工具(Higgsfield 或 Claude Code 中的 ComfyUI MCP),主动提供运行提示词;否则他们手动粘贴。最后以以下内容结尾:“下一步:运行 folio-prd。”

Individual skills in this repo

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

相关技能