mcpField
Y
youtube-short-maker

youtube-short-maker

github.com/pexoai创意与媒体81699 次安装10 周前更新
代码仓库

关于 youtube-short-maker

此技能将主题转交给 Pexo，跟进制作带有镜头、音乐和字幕的竖屏 YouTube Short，适合希望由 Pexo 负责脚本和创意决策的用户。

主要功能

  1. 01创建并跟踪 Pexo 项目
  2. 02上传用户提供的素材
  3. 03原样转交主题
  4. 04处理预览与修改
  5. 05交付最终短片

适用场景

  1. 01根据主题制作 YouTube Short
  2. 02加入用户提供的图片或视频
  3. 03在同一项目中修改已交付短片

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pexoai/pexo-skills --skill youtube-short-maker

安装后在 Claude Code 中输入/youtube-short-maker确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
SETUP-CHECKLIST.md
TROUBLESHOOTING.md
scripts/
_common.sh
pexo-asset-get.sh
pexo-chat.sh
pexo-doctor.sh
pexo-entitlements.sh
pexo-project-create.sh
pexo-project-get.sh
pexo-project-list.sh
pexo-upload.sh

详细介绍

YouTube Shorts 制作器 — Pexo

Pexo： https://pexo.ai — 在此获取 API 密钥、查看项目渲染进度并购买点数。

制作一条有助于留住观众的成品 YouTube Short——竖屏，并以吸引人的开场为先。你将用户的 主题交给托管的 Pexo Agent 并交付结果；Pexo 会编写脚本、生成镜头，并为 Short 配上音乐和字幕。

你的职责：转交请求，而非创作

创建项目，原样发送用户的请求，轮询并交付。所有创意工作——脚本编写、模型选择、提示词和音乐——均由 Pexo 后端处理。自行添加指导（时长、风格、用户未要求的模型）会覆盖 Pexo 的判断，导致视频效果变差。

配置

~/.pexo/config：

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<your-api-key>"

没有账户／首次运行 → 阅读 references/SETUP-CHECKLIST.md 并指导用户完成设置——其中包含注册流程和可让新用户获得奖励点数的邀请码，以及如何创建上述配置。配置错误 → 运行 scripts/pexo-doctor.sh 并遵循其输出。

工作流

脚本位于此技能的 scripts/ 目录中。使用用户的语言回复。

  1. 创建项目： pexo-project-create.sh "<short brief>" → 保存 project_id。
  2. 上传用户提供的文件： pexo-upload.sh <project_id> <path> → 保存 asset_id， 并以内嵌形式引用：<original-image>asset_id</original-image>（或 <original-video> / <original-audio>）。必须添加标签——单独的 asset_id 会被忽略。Pexo 无法抓取 URL——请先下载，再上传。
  3. 发送请求： pexo-chat.sh <project_id> "<用户的原话> <asset tags>"。 完全照抄用户的话；只能添加资源标签。
  4. 告知用户（使用其语言）：已提交 ✓ · 约 15–20 分钟 · https://pexo.ai/project/<project_id>。
  5. 轮询： 每隔 ≥60 秒运行 pexo-project-get.sh <project_id>，并根据 nextAction 采取相应操作：
    • WAIT → 继续轮询；每轮约 5 次轮询后发送一条包含项目链接的简短进度更新。
    • RESPOND → 处理 recentMessages 中的每条事件：转达 Pexo 的文本（如果 Pexo 提问，则等待用户回答，再用 pexo-chat.sh 发送用户的回复）；对于 preview_video，针对每个选项运行 pexo-asset-get.sh <project_id> <assetId>，展示 URL（A/B/C），让用户选择，然后运行 pexo-chat.sh <project_id> "<choice>" --choice <assetId>；对于 document 事件，告知用户。
    • DELIVER → 运行 pexo-asset-get.sh <project_id> <final assetId>，然后将完整资源 URL 作为纯文本发送给用户——保留所有 ?… 查询参数，绝不能截断或用 Markdown 包裹——并附上项目链接。
    • FAILED → 用通俗易懂的语言解释 nextActionHint，并询问用户是否重试。
    • RECONNECT → 运行 pexo-chat.sh <project_id> "continue"，告知用户连接已断开，你正在恢复，然后继续轮询。
    • 在 WAIT 期间绝不调用 pexo-chat.sh——这会触发重复制作。
    • 耗时过长 → 如果已超过 30 分钟且仍处于 WAIT，告知用户任务耗时较长（附上项目链接和 https://pexo.ai/connect/openclaw）；询问用户要继续等待还是停止。不要无限轮询。

修改

交付后，如果用户要求调整（“缩短一点”“换首音乐”“换个镜头”），请沿用同一个项目：运行 pexo-chat.sh <project_id> "<用户的反馈>"，然后再次轮询（步骤 5）。修改时绝不要创建新项目——那会丢弃 Pexo 服务端的上下文。

点数

如果脚本因“Credits balance”／“Insufficient credits”而失败：如果错误信息中包含购买链接，就将链接发给用户；否则告知用户前往 https://pexo.ai/home → Credits → Buy Credits 添加点数。用户确认后重试。

示例

用户：“制作一条关于改善睡眠的 3 个快速技巧的 YouTube Short。”

pid=$(pexo-project-create.sh "better sleep tips short")
pexo-chat.sh "$pid" "Make a YouTube Short on 3 quick tips for better sleep."
# Tell the user: submitted, ~15–20 min, https://pexo.ai/project/$pid
# Poll pexo-project-get.sh "$pid" until nextAction is DELIVER, then deliver the asset URL.

脚本

脚本用法返回值
pexo-project-create.sh"<brief>"project_id
pexo-upload.sh<project_id> <file>asset_id
pexo-chat.sh<project_id> "<message>" [--choice <id>]确认（异步）
pexo-project-get.sh<project_id>JSON：nextAction、recentMessages
pexo-asset-get.sh<project_id> <asset_id>包含 url 的 JSON
pexo-doctor.sh—设置诊断

错误代码和边缘情况 → references/TROUBLESHOOTING.md。

评论

支持 Markdown