Communitygithub.com

beachyphotoandfilm-arch/video-skills

将完成的短视频从DaVinci Resolve渲染输出,以创作者的风格撰写文案,为每个Instagram帖子添加自定义封面,并通过Metricool将内容排期发布到Instagram、TikTok和YouTube Shorts。它会处理Google Drive上传环节、检查现有日历的冲突并执行清理工作。触发词包括“安排短视频”、“发布这些”、“将这些加入日历”,或在短视频审核通过后自动触发。

video-skills 是什么?

这是一个用于自动化短视频发布流程的AI助手技能,主要面向使用DaVinci Resolve剪辑并需要将内容发布到多个社交媒体平台的创作者。该技能能够直接从Resolve项目渲染短视频,生成符合创作者语气和风格的文案,为Instagram创建自定义封面,并通过Metricool工具将内容排期发布到Instagram、TikTok和YouTube Shorts。其核心工作流程包括一个关键步骤:由于Metricool的API仅接受公共URL,因此需要先将本地文件上传到Google Drive的共享文件夹,获取直接下载链接后再提交。该技能还内置了智能排期算法,会自动检测日历中的空闲时段,避免内容冲突,并在发布完成后清理临时文件。它支持{blogId, timezone, connected accounts}等自定义品牌配置,用户只需在`SKILL.md`中填写占位符即可启用。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/beachyphotoandfilm-arch/video-skills/tree/HEAD/skills/schedule-social

在你喜欢的 AI 中提问

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

文档

排期发布到社交媒体

设置:填写以下内容

在首次运行前,替换下方所有占位符。

占位符说明
<YOUR_METRICOOL_BLOG_ID>您的Metricool品牌的blogId(从getBrandSettings获取)
<YOUR_TIMEZONE>排期使用的IANA时区,例如America/Chicago
<YOUR_POST_TIME>每日默认发布时间,例如10:00
<YOUR_IG_HANDLE>, <YOUR_TIKTOK_HANDLE>, <YOUR_YOUTUBE_CHANNEL_ID>在Metricool中连接的账号
<YOUR_DRIVE_UPLOAD_FOLDER_ID>一个Google Drive文件夹,设置为“拥有链接的任何人均可查看”(参见媒体跳转部分)
<YOUR_VIDEO_LIBRARY>已完成文件的存放位置,例如~/Videos/Finished
<YOUR_STANDING_CTA>可选的结尾语,用于每条文案末尾
<YOUR_VOICE_FILE>可选:语音/风格指南文件的路径,用于文案撰写

品牌: blogId <YOUR_METRICOOL_BLOG_ID>,时区 <YOUR_TIMEZONE>。 已连接的账号: Instagram(<YOUR_IG_HANDLE>),TikTok(<YOUR_TIKTOK_HANDLE>),YouTube(<YOUR_YOUTUBE_CHANNEL_ID>)。

媒体跳转(这部分不太直观)

Metricool的API仅接受公共URL。它不能接受本地文件。工作链路如下:

  1. 将MP4文件上传到Drive文件夹,例如**Metricool Uploads (Claude)**(<YOUR_DRIVE_UPLOAD_FOLDER_ID>)。将该文件夹设置为“拥有链接的任何人均可查看”一次;文件会继承该权限,因此无需为每个文件单独设置共享。
    cd <文件所在目录> && gws drive files create \
      --params '{"uploadType":"multipart","supportsAllDrives":true}' \
      --json '{"name":"<名称>.mp4","mimeType":"video/mp4","parents":["<YOUR_DRIVE_UPLOAD_FOLDER_ID>"]}' \
      --upload "<文件>"
    
  2. 使用直接下载URL进行排期:https://drive.google.com/uc?id=<fileId>&export=download。 /view链接会导致“无法规范化媒体”错误。
  3. Metricool将文件复制到自己的存储空间;响应中的media字段会变为static.metricool.com/...。
  4. 看到该变化后,删除Drive中的副本。这样可以避免存储空间不断累积。

Claude通常无法将Drive文件设为公开(沙箱会阻止该操作),也无法编辑其自身权限。这就是共享文件夹存在的原因。如果文件最终位于文件夹之外,请要求用户将其移入,而不是尝试进行共享。

文案

如果您有语音指南,请先阅读<YOUR_VOICE_FILE>并遵循其风格。否则,使用以下默认规则。

当短视频包含评论关键词CTA(一个触发自动私信或邮件的关键词)时,第一行是CTA:

  • 第一行: 评论 <KEYWORD>,我将免费为您发送 <资源名称> 👇,关键词全部大写,与短视频CTA片段中说的完全一致。
  • 然后是钩子行和下方的2-4行教学内容。
  • 结尾使用固定CTA(如果您使用的话)。
  • 关键词必须与短视频中说的CTA一致(视频状态文件中的reel_cta)。每个视频一个关键词。

无关键词CTA的短视频格式:

  • 第一行是钩子。 这是信息流中显示的唯一一行。通常与短视频开场的第一句话相同。
  • 2-4行简短文字,教授一个知识点。行与行之间用换行符分隔,不要写成段落。
  • 不要滥用标签。尽量少用或不用。
  • 使用固定CTA <YOUR_STANDING_CTA> 结尾(如果有的话)。

根据短视频的实际内容编写,使用创作者的原文措辞,而不是泛泛的建议。简短但有教育意义:观众仅从文案就能学到一条有用的信息。

通用示例:

“每天发帖 = 倦怠 / 每周发3个优质视频 = 增长”

“一个小技巧:如果您想要更好的音质,请将麦克风放近一点,而不是提高增益...”

渲染

文案是叠加在视频上的:video-reels将其作为V3轨道的alpha叠加素材放置,文本钩子卡片位于V2轨道。无需导入,无需勾选叠加复选框。

  1. 用户对短视频进行修剪。两条叠加轨道是独立的素材,因此修剪V1轨道不会移动它们。如果重新剪辑了时间线,请重新渲染该短视频的文案,而不是滑动它们。
  2. Claude通过Resolve API渲染它们。 四个短视频大约需要90秒。
out = os.path.expanduser("~/Movies/<video>-deliverables/reels-final")
os.makedirs(out, exist_ok=True)
project.DeleteAllRenderJobs()
for i in range(project.GetTimelineCount()):
    t = project.GetTimelineByIndex(i+1)
    if not t.GetName().startswith("Reel"):
        continue
    project.SetCurrentTimeline(t)
    project.SetRenderSettings({"TargetDir": out, "CustomName": t.GetName().replace(" ", "_"),
                               "SelectAllFrames": True, "FormatWidth": 1080, "FormatHeight": 1920,
                               "ExportVideo": True, "ExportAudio": True})
    project.SetCurrentRenderFormatAndCodec("mp4", "H264")
    project.AddRenderJob()

然后调用start_rendering。编解码器字符串是"H264",而不是"H.264",格式是"mp4"。轮询输出目录而不是作业状态;文件在完成后会直接出现。30秒的短视频预计约40MB。 3. 渲染是时间线的不可逆点,因此请先完成所有修剪工作。 4. 在上传前使用ffmpeg抽检输出,在钩子窗口内抽一帧,在短视频中间抽一帧:

ffmpeg -v error -ss 1.5 -i reel.mp4 -frames:v 1 hook.png -y
ffmpeg -v error -ss 8   -i reel.mp4 -frames:v 1 cap.png  -y

将它们堆叠成一张校对表并实际查看。这是捕获缺失钩子卡片或空白文案轨道的最后一环,排期后无法删除。

已完成文件的存储位置

保留的所有内容都存放在<YOUR_VIDEO_LIBRARY>/目录下,每个视频一个文件夹:

<YOUR_VIDEO_LIBRARY>/<视频名称> YYYY-MM-DD/
    Reels/              发布的内容。1080x1920 H.264
    Reels/Masters/      相同剪辑,60 Mbps存档
    Timelines/          每个时间线的.drt文件 + 项目.drp文件
    Covers/             已批准的Instagram短视频封面,1080x1920 JPG
    Thumbnails/         完整尺寸的缩略图选项
    YouTube/            导出的长视频版,交付版+主存档
    Posting schedule.txt   发布内容、发布位置和发布时间的记录

上传文件:达到Instagram发布API允许的最高质量

Metricool通过Meta的内容发布API发帖,该API对其接受的内容有上限。上传符合这些上限的最佳文件,文件由60 Mbps主存档生成,而非Resolve的交付渲染:

  • H.264 High, yuv420p, 1080x1920, 封闭GOP, moov at the front(+faststart)
  • 视频最高24 Mbps(上限是25),音频AAC 128 kbps 48 kHz(Resolve会输出320 kbps,超出限制)
  • 仅包含视频和音频流。 Resolve会添加一个时间码数据轨道;使用-dn将其删除
ffmpeg -i "Masters/<n>.mp4" -map 0:v:0 -map 0:a:0 -map_metadata -1 -dn \
  -c:v libx264 -preset slow -crf 11 -maxrate 24M -bufsize 48M -pix_fmt yuv420p -profile:v high \
  -g 48 -keyint_min 48 -sc_threshold 0 -flags +cgop \
  -c:a aac -b:a 128k -ar 48000 -movflags +faststart "Reels/<n>.mp4"

在CRF 16下,仅人物对话素材仅使用了约8 Mbps,因此CRF 11会消耗更多预算。在后台运行此命令,因为使用-preset slow时,多个短视频可能需要几分钟。一次只编码一个文件,不要并行编码: 多个并行编码可能会在写入过程中填满磁盘,导致每个文件截断。Instagram仍然会在其端重新压缩;这确保了它从尽可能干净的源文件开始。

每个短视频进行两次渲染,而不是一次。 相同编解码器,相同分辨率,不同比特率:

分辨率比特率用途
交付版1080x1920 H.264Resolve处理,然后由上述上传文件替换上传
主存档1080x1920 H.264通过"VideoQuality": 60000设置60 Mbps存档

长视频版本(1920x1080)同样进行两次处理:10分钟视频约900MB交付版,约4.5GB主存档。

1080x1920是正确的分辨率:无论哪种方式,Instagram都以1080宽度提供,并且短视频裁剪已经是从4K过采样得到的。除非被要求,否则不要提供ProRes或更大的画幅。

VideoQuality 是粘性的。每次传递都必须设置。

渲染设置存在于项目中,而不是作业中。如果在SetRenderSettings调用中遗漏VideoQuality,渲染会静默复用上一次的设置。继承自短视频主存档的60000的长视频交付版,其输出体积会比预期大5倍。

project.SetRenderSettings({..., "VideoQuality": 12000})   # 交付版,~12 Mbps
project.SetRenderSettings({..., "VideoQuality": 60000})   # 主存档,~60 Mbps

永远不要依赖交付版的默认值。并且永远不要相信作业列表: 即使VideoQuality已应用,从GetRenderJobList()读取时仍可能返回None。检查已完成文件:

ffprobe -v error -select_streams v:0 -show_entries stream=bit_rate -of csv=p=0 out.mp4

在排队长视频对之前检查可用空间。 60 Mbps下10分钟的主存档约4.5GB。

同时将时间线导出到文件夹中,这样无需项目数据库即可移植编辑:

for i in range(project.GetTimelineCount()):
    t = project.GetTimelineByIndex(i+1)
    t.Export(os.path.join(d, t.GetName() + ".drt"), resolve.EXPORT_DRT)
resolve.GetProjectManager().ExportProject(project.GetName(), os.path.join(d, project.GetName() + ".drp"))
  • 直接渲染到目标文件夹。 将Resolve的TargetDir设置为<该文件夹>/Reels,这样之后无需移动任何内容。
  • 根据Resolve时间线名称重命名。 Reel_2_-_my_best_tip.mp4 变为 2. my best tip.mp4:按数字排序以便于排序,一目了然。主存档和.drt文件的名称相同,这样三个文件夹可以对应起来。
  • 移动,而不是复制。 ~/Movies/<video>-* 目录保存工作文件(whisper JSON、SRT、叠加mov、文案mov)。这些文件保留用于重新渲染;已完成导出的文件将移走。
  • 排期完成后编写Posting schedule.txt,列出每个短视频的日期、时间和网络,这样用户无需打开Metricool即可知道哪些内容已发布。

仅当渲染因空间不足而实际失败,或者长视频对明显无法放入时,才提及磁盘空间。

封面(仅限Instagram)

每个短视频在排期前都会获得一个自定义的Instagram封面。在文案获得批准后、排期之前,运行reel-covers技能。它会为每个短视频返回一个经批准的JPG文件,存放在<Video>/Covers/目录下。在文案和时间审核的同时展示封面,以便一次性批准所有内容。

通过与视频相同的Drive跳转方式(同一文件夹<YOUR_DRIVE_UPLOAD_FOLDER_ID>,mimeType: image/jpeg)上传每个封面,并使用uc?id=...&export=download形式作为videoThumbnailUrl传递。一旦Metricool拥有自己的副本后,删除Drive中的副本,方法与视频相同。

排期

每个短视频一条帖子,包含所有三个网络,并包含封面。 封面仅对Instagram有意义。TikTok的个人账号会忽略它,YouTube Shorts仅在经过验证的频道上显示它。不要拆分帖子。

"providers":[{"network":"instagram"},{"network":"tiktok"},{"network":"youtube"}],
"media":["https://drive.google.com/uc?id=<video id>&export=download"],
"videoThumbnailUrl":"https://drive.google.com/uc?id=<cover id>&export=download",
"instagramData":{"type":"REEL","showReelOnFeed":true,"isAiGenerated":false},
"tiktokData":{"privacyOption":"PUBLIC_TO_EVERYONE","title":"<short title>"},
"youtubeData":{"type":"short","privacy":"public","madeForKids":false,"title":"<title, <100 chars>"}
  • 向已排期的帖子添加封面: 使用updateScheduledPost,传入帖子的完整原始字段(文本、提供者、媒体、所有网络数据、日期)以及videoThumbnailUrl。它会覆盖原有内容且不可撤销,因此请从getScheduledPosts逐字复制字段。切勿替换现有的videoThumbnailUrl或videoCoverMilliseconds:已有这些字段的帖子已经选定了封面。
  • 如果某个更新因“无法规范化媒体”失败而其他更新成功,则本次从Drive的获取失败了。该帖子保持不变。重新上传文件(获取新的id)并重试。重试相同的URL不会有效。
  • 然后使用getScheduledPosts检查每个帖子的videoThumbnailUrl现在是否以static.metricool.com开头,并删除Drive中的副本。
  • YouTube需要标题和madeForKids字段。 TikTok需要简短标题。
  • autoPublish: true 让Metricool自动发布。

何时排期(默认规则,可按喜好调整)

从明天开始。每天一条帖子。如果某天已有内容,则移到下一个空闲日。

day = 明天
for each post in order:
    while day already has a scheduled post:  day += 1
    schedule at <YOUR_POST_TIME> local on day
    day += 1
  • <YOUR_POST_TIME> in <YOUR_TIMEZONE> 是默认发布时间。
  • 始终先调用getScheduledPosts,覆盖从明天到明天+(帖子数量+14天)的范围,以便查看空白时段。跳过此检查可能会导致帖子落在已被占用的时间段。
  • 如果某天任何内容被排期(包括草稿),则视为被占用。
  • 不要将多个帖子挤在同一天,也不要留空:目标是立即开始、稳定连续的每日发布。
  • 切勿在文案文本中添加测试标签。 不要使用“测试草稿”,不要使用“可删除”。文案始终是最终版本,即使在测试运行中也是如此;用户可能希望保留它。 使用**draft: true + autoPublish: false** 标记测试帖子(草稿在规划器中视觉上不同),并提供plannerUrl和帖子id以便一键删除。

长视频YouTube(主视频,非Shorts)

建议:不要通过Metricool发送大型长视频文件。请直接在YouTube Studio中上传。 通过Metricool发送约1GB的导出文件可能会在传输过程中被截断存储。Resolve将MP4索引(moov)放在文件末尾,因此截断的副本不可读,YouTube会在“发布”后报告“处理中止”。Metricool可能不会报告错误。将文件、标题、描述和缩略图交给用户,让他们粘贴到Studio中,以4K渲染(Studio没有文件大小问题)。以下内容仅供参考。

如果对大型文件使用Metricool,请检查存储的...

Individual skills in this repo

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

beachyphotoandfilm-arch/video-skills

Sync camera footage to a separate lapel or field-recorder track (e.g. Tascam DR-10L and similar) and lay it up in DaVinci Resolve. Stitches the recorder's split files, finds each clip's exact place in the audio by matching words then waveforms, cuts one lapel slice per clip so every later skill works unchanged, checks for clipping, and builds a synced timeline in a new Resolve project. Trigger on "sync the lapel", "sync my audio", "line up the recorder", "I used a lav", or any shoot with a separate audio folder (live talks, events, workshops). Run it before paper-edit or video-reels.

beachyphotoandfilm-arch/video-skills

Turn raw talking-head footage into an assembled rough cut inside DaVinci Resolve. Pulls the clips off your footage drive, transcribes them locally, removes failed takes, restarts, asides and dead air, then creates a new Resolve project with two paper-edit timelines ready for your fine trim. Trigger on "paper edit", "cut my raw footage", "make a rough cut", "clean up this video", or when the user points at a folder of raw camera files for a YouTube video.

beachyphotoandfilm-arch/video-skills

Design a unique Instagram cover for each reel in your house style. Reads what the reel is about, writes a short hook headline, picks one of your own photos from a tagged photo library, lays it out like your existing covers, and proofs it in grid view at phone size. Renders locally, never with AI image generation. Can be called by a scheduling skill before reels are scheduled. Trigger on "make covers", "reel covers", "cover photo for this reel", "design the IG covers".

beachyphotoandfilm-arch/video-skills

Build animated brand overlays (motion graphics) for a talking-head video, timed to the speaker's exact words, plus a DaVinci Resolve import file. House style is in-scene type (text beside and behind the speaker's head) plus diagrams. Transcribes the rough cut locally, picks the moments, renders transparent .mov clips, and writes an FCPXML that drops every clip onto the timeline already in position. Trigger on "make animations for this video", "add overlays/motion graphics", "animate this", "b-roll graphics for my YouTube video", or when the user shares a rough cut and asks for graphics.

beachyphotoandfilm-arch/video-skills

Cut vertical Instagram reels out of a long-form talking-head video, hook first. Picks the strongest standalone moments from the transcript, opens each reel on its punchiest line, builds vertical timelines in DaVinci Resolve framed on the speaker's face with the LUT applied, and finishes them: a hook (a held text card, or a word-by-word "build" hook with punch-in) and burned-look captions on V3; this-or-that reels get product graphics and a comment-keyword CTA card. You trim and render, nothing to import. Trigger on "make reels", "clip this for Instagram", "cut some verticals", or after a YouTube video is cut.

beachyphotoandfilm-arch/video-skills

Design YouTube thumbnails and titles for a talking-head video. Pulls graded full-res frames out of the raw footage, renders brand-styled variants in two proven layouts, and proofs them at phone size where the click actually gets decided. Trigger on "make thumbnails", "thumbnail for this video", "title and thumbnail", or after a video is cut.

beachyphotoandfilm-arch/video-skills

Run the whole YouTube video pipeline end to end, one stage at a time, stopping for the creator's approval at every gate. Paper edit, punch-ins, reels, reel covers, scheduling the reels, overlays, thumbnail and title, then scheduling the long-form video, all through Metricool. Keeps state per video so you can stop anywhere and pick up later. Trigger on "/youtube", "let's do the whole video", "run the video pipeline", "continue the <name> video", or when handed raw footage for a YouTube video.

相关技能