Communitygithub.com

互动站点

为用户的互动视频制作托管站点:页面、区块、主题与发布。适用于个人网站、作品集或链接页面。

互动站点 是什么?

该技能用于创建并管理托管在 `https://{prefix}.interactive.vidmoat.com` 的互动站点。每个站点完全属于用户,仅展示其发布的互动视频,不包含第三方元素。核心工具包括 `get_interactive_site`、`edit_interactive_site` 和 `publish_interactive_site`,支持 MCP 和 API 调用。工作流强调“先读取后修改”,仅在获取站点状态(包括页面、分区 ID、问题和修订号)后再进行批量编辑,并使用修订号确保一致性。站点仅收录已发布且公开共享的视频,用户可设置深色/浅色主题、调色板、字体样式和排版密度。页面结构有明确顺序:首页包含 hero(主打视频)、视频网格、说明区域(故事、文字、关于),最后是号召性用语或链接。支持暗色与亮色主题分别匹配电影感和教程类内容。技能严格禁止自定义 HTML/CSS/脚本,区块大小和字符数有上限(如页面不超过 6 页,每页 12 个区块),超出限制会被拒绝而非截断。发布前提供临时预览 URL,发布后站点将对搜索引擎可见。整体旨在帮助不具备技术背景的用户快速搭建专业的互动视频展示站点。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vidmoat/skills/tree/HEAD/skills/vidmoat/interactive-sites

在你喜欢的 AI 中提问

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

文档

构建互动站点

托管在 https://{prefix}.interactive.vidmoat.com 的站点是用户个人互动视频的家园,周围没有我们的任何元素。视频是核心,站点是框架。每个页面都应在用户到达播放器之前完成引导。

工具:get_interactive_site、edit_interactive_site、publish_interactive_site(支持 MCP 和 API)。在应用程序中,相同调用通过 agentWorkspace 发送,附带 action: "interactive_site" 和 site: {tool, ...arguments}。

工作流程

  1. 先读取。 使用带 videos: true 参数的 get_interactive_site。它会返回站点是否存在(canCreate)、其页面、每个 sectionId、问题列表(problems)和修订号(rev)。只能按 sectionId 修改被要求的项,并传回 rev。
  2. 仅限已发布且共享的视频。 站点只显示账户中已发布且共享的互动视频;使用 videos: true 可精确列出这些视频及其 ID。如果用户命名的视频不在列表中,则需先将其发布(publish_interactive 带 share: true,在用户同意后),绝不能猜测或替换为其他视频。
  3. 命名一次。 先用 get_interactive_site 检查名称(带 prefix: "名称"),限制尝试一两次,不要循环猜测。然后使用 edit_interactive_site 配合 create: {prefix, title} 创建站点。使用用户自己的姓名或品牌;每个账户只能有一个站点。
  4. 一套主题。 setTheme 包含:tone(dark、light)、palette(warm、neutral、cool、forest、plum)、font 和 headingFont(system、serif、mono、rounded)、corners(soft、round、square)、density(comfortable、compact、airy)、width(normal、narrow、wide)、playerAccent(video 保留每个视频自身外观,site 使用站点的主题色)、accent 颜色值 #RRGGBB。深色主题适合电影感或夜间拍摄的素材,浅色适合教程和课程。省略某个令牌则保留其默认值。
  5. 首页按此顺序排列: 首先一个 hero(标题、一句话说明、最强视频作为 video、一个按钮),然后是其余视频的 grid,接着是说明部分(分支电影的 story、text、about),最后是 cta 或 links。只放置一个特色视频,不要放三个。
  6. 少量页面。 通常首页就足够了。只有当内容超过一屏时,才添加 films 或 about 页面。setNav 列出页面;setHeader 提供标题、标语以及从 images: true 获取的 Logo。
  7. 批量编辑。 一次 edit_interactive_site 调用包含所有 ops(全部应用或全部不应用),然后读取回复中的 problems。
  8. 展示,然后发布。 向用户提供 previewUrl(草稿的实际地址,有效期一小时)。只有当用户要求时才使用 publish_interactive_site 发布——它是一个公开页面。使用 publish: false 可立即下线。

示例

{"create": {"prefix": "river-films", "title": "River Films"}}
{"rev": 3, "ops": [
  {"op": "setTheme", "tone": "dark", "palette": "cool", "headingFont": "serif", "accent": "#4CC9F0"},
  {"op": "setHeader", "title": "River Films", "tagline": "Short films you play"},
  {"op": "addPage", "slug": "films", "title": "Films"},
  {"op": "setNav", "links": [{"label": "Home", "page": ""}, {"label": "Films", "page": "films"}]},
  {"op": "addSection", "page": "", "section": {"kind": "hero", "heading": "Films where you choose what happens next", "body": "Pick a path, then go back and take the other one.", "video": "<id from videos:true>", "cta": {"label": "See every film", "page": "films"}}},
  {"op": "addSection", "page": "", "section": {"kind": "grid", "heading": "Play them all", "videos": ["<id>", "<id>"], "columns": 3}},
  {"op": "addSection", "page": "", "section": {"kind": "story", "video": "<id>", "heading": "How it branches"}}
]}
{"rev": 4, "ops": [{"op": "updateSection", "sectionId": "<from the digest>", "set": {"heading": "New films every month", "body": null}}]}

注意事项

  • 无自定义代码。 禁止任何 HTML、CSS、脚本、嵌入或“自定义样式”;切勿提供这些选项。被拒绝的值会附带允许列表返回:从列表中选取。
  • 页面 "" 是首页。 其他页面是 slug(如 films、about);重命名 slug 后,其链接会自动更新。
  • 按钮(cta)可以是 {label, page} 或 {label, href}(href 必须是 https 地址)。links 也必须是 https 地址。
  • text 是受限的 Markdown: 仅支持 ## 和 ###、列表、粗体、斜体、https 链接。不支持 HTML 和图片。
  • about 区块使用的图片 ID 来自 images: true,绝不能是 URL。
  • 强调色可能被拒绝,如果其上文字或页面上文字难以阅读。深色背景尝试用较浅的强调色,浅色背景用较深的。
  • 限制会被拒绝而非截断: 页面最多 6 页、每页最多 12 个区块、网格最多 12 个视频、导航链接最多 6 个、链接最多 10 个;标题最多 90 个字符、正文最多 600 个字符。内容需自行精简。
  • null 移除 updateSection 中的可选字段;省略该字段则保留原值。
  • 搜索引擎可以找到已发布的站点(附带站点地图和视频数据)。为每个页面编写面向陌生搜索者的 title 和 description;setSettings 中的 indexing: false 可在用户希望站点私有时阻止索引。
  • 故事地图会破坏谜题体验。 默认情况下只显示开头和答案,并统计场景和结局数量。仅在教程或指南中使用 reveal: "full",绝不能在游戏或谜题中使用,也不能放在承诺机密的文案旁边。
  • 海报很重要。 播放器和网格卡片在视频播放前显示海报;应选择海报是真实标题卡片的视频,而不是黑色的第一帧。
  • 重命名地址(使用 edit_interactive_site 的 prefix 参数)会保留旧名称并在一段时间内转发;不要随意重命名。
  • Hobby 账户 会被拒绝并附带原因;直接说明,不要绕开限制。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

vidmoat/caption-styling

Style, time and place captions and subtitles so they read on a phone with the sound off. Sets line length, reading speed, cue timing, size, contrast and platform safe zones, and checks SRT or VTT files against them. Use when the user wants captions or subtitles added, restyled, fixed or made accessible, says captions are too fast, too small or hidden under app buttons, or is preparing TikTok, Reels, Shorts or YouTube video, even if they only ask to "put what I say on screen".

vidmoat/layered-motion

Motion graphics people can edit afterwards: compositions of layers with keyframes, After Effects style. Use for lower thirds, animated titles, kinetic type, stat reveals, logo stings and callouts that the person may want to retime or restyle by hand, and when a composition is already on the timeline.

vidmoat/motion-graphics

Designed graphics with HTML elements, animating the objects inside them on the timeline clock. Use for animated stat cards, infographics, diagrams, UI mockups, logo stings, or moving an object inside a graphic.

vidmoat/video-essayist

Video Essayist specialist, tagged @video-essayist or consulted for script-led commentary and analysis: narration locked first, every line matched to a visual that proves it, short annotated clips, quotes with sources, thesis by 60 seconds, chapters. Use when the user tags @video-essayist or asks for a video essay, film analysis or commentary edit.

vidmoat/wedding-filmmaker

Wedding & Event Filmmaker specialist, tagged @wedding-filmmaker or consulted for wedding and event highlight films, teasers and vertical teasers: the couple's own words as the spine, cut to licensed music, slow motion only on peaks, true skin and an unclipped dress. Use when the user tags @wedding-filmmaker or asks for a wedding or event highlight video.

相关技能