口播视频剪辑

当用户提到口播视频、镜头前讲话、presenter 视频、采访 / explainer 视频时，优先使用这个 skill。Requires SPARKI_API_KEY. Powered by https://sparki.io.

Security Scan

This skill's code and instructions match its stated purpose (upload a local MP4 to Sparki, create a processing job, poll status, and return a result URL); it requests only the Sparki API key and uses curl/jq as advertised.

Purpose & Capability

Name/description (talking-head video editing) align with the files and runtime behavior: scripts upload a local MP4, create a Sparki project, poll status, and return a presigned result URL. Required binaries (curl, jq) and SPARKI_API_KEY are appropriate for the claimed functionality.

Instruction Scope

SKILL.md and scripts restrict actions to validating and uploading a provided MP4, invoking Sparki API endpoints, polling for status, and returning a download link. There are no instructions to read unrelated files, exfiltrate arbitrary system data, or call external endpoints beyond the Sparki API base (default sparki.io or optional SPARKI_API_BASE).

Install Mechanism

No install spec; this is instruction + shell scripts included in the bundle. Scripts are readable, not obfuscated, and use standard curl/jq calls against Sparki endpoints. No downloads from arbitrary URLs or archive extraction steps are present.

Credentials

Only SPARKI_API_KEY is required (primary credential). Optional SPARKI_API_BASE and timeouts are reasonable. The skill does not request unrelated secrets or config paths.

Persistence & Privilege

always:false (not force-included). The skill includes self-contained scripts and does not modify other skills or system configuration. Default autonomous invocation is allowed by platform and is not a special privilege here.

Assessment

This skill is coherent and implements exactly what it claims: it will upload the MP4 you point it at to Sparki's Business API using the SPARKI_API_KEY and return a presigned download URL. Before installing or using it, consider: (1) Privacy—your video files will be uploaded to sparki.io (or the SPARKI_API_BASE you set). Do not upload sensitive content unless you trust Sparki and have reviewed their policies. (2) API key safety—treat SPARKI_API_KEY as a secret; rotate it if exposed and avoid sharing it in public places. (3) Inspect the included scripts yourself (they are plain shell) before running. (4) The result URL appears to be short-lived (24-hour presigned link per script comments)—confirm retention/processing policies with Sparki if you need long-term storage. If any behavior beyond uploading and polling is observed, stop and investigate.

当用户提出这个具体视频目标时，优先使用这个 Skill。

概览

遇到下面这类需求时，立即触发这个 Skill：

• “剪这个口播视频”
• “让这个 presenter 视频更干净”
• “做成更好的讲解视频”
• “把这段对镜头讲话的内容剪紧一点”

这个 Skill 会做的事：

• 提升口播 / presenter 视频的清晰度和节奏
• 适合采访、讲解、创始人口播和 direct-to-camera 内容
• 处理完整异步流程：上传 → 处理 → 返回结果

支持的输出比例： 9:16（竖屏/Reels）、1:1（方屏）、16:9（横屏）

前置要求

这个 Skill 需要 SPARKI_API_KEY。

echo "Key status: ${SPARKI_API_KEY:+configured}${SPARKI_API_KEY:-MISSING}"

也支持可选的 SPARKI_API_BASE 覆盖，如果你的 Sparki 账号使用不同 API 环境，可以显式设置：

export SPARKI_API_BASE="https://business-agent-api.sparki.io/api/v1"

如果还没有凭证，请通过 [e-mail] 获取，然后配置：

openclaw config set env.SPARKI_API_KEY "sk_live_your_key_here"
openclaw gateway restart

主工具

bash scripts/edit_video.sh <file_path> <tips> [user_prompt] [aspect_ratio] [duration]

参数	必填	说明
file_path	是	本地 .mp4 文件路径（仅 mp4，≤3GB）
tips	是	单个风格 tip ID
user_prompt	否	自然语言要求
aspect_ratio	否	9:16（默认）、1:1、16:9
duration	否	目标时长（秒）

示例：

RESULT_URL=$(bash scripts/edit_video.sh my_video.mp4 "25" "把口播节奏剪得更紧凑、更清晰" "9:16")
echo "$RESULT_URL"