AI Commentary

Use this skill when the user asks for a commentary-style video, narrated feel, explainer tone, or commentary-driven edit. Requires SPARKI_API_KEY. Powered by...

Security Scan

The skill is a coherent wrapper around Sparki's Business API for commentary-style video edits: it only needs a Sparki API key, curl and jq, and the included scripts perform the expected upload → process → poll workflow to Sparki endpoints.

Purpose & Capability

Name/description, required env var (SPARKI_API_KEY), required binaries (curl, jq), homepage (sparki.io), and the scripts all align: the code uploads mp4s, creates processing jobs, polls status, and returns a pre-signed result URL — exactly what a Sparki wrapper would need.

Instruction Scope

Runtime instructions and scripts are narrowly scoped to validating local mp4 files and calling Sparki API endpoints. They do upload user video files to a third-party endpoint (SPARKI_API_BASE) and return a pre-signed URL — expected for this functionality but has privacy implications the user should consider. SKILL.md's advice to 'trigger first and proactively' is an operational suggestion, not an access escalation, but it may cause frequent automatic invocation if the agent is configured to do so.

Install Mechanism

No install spec (instruction-only) so nothing is downloaded at install time. The repository includes bash scripts that will run locally; no remote code downloads or obscure installers are used.

Credentials

Only SPARKI_API_KEY (primary) is required, plus an optional SPARKI_API_BASE override. No unrelated credentials, system config paths, or broad secret access are requested.

Persistence & Privilege

always:false and default model invocation settings are used. The skill does not request permanent/global agent changes or access to other skills' configs.

Assessment

This skill appears internally consistent and performs the expected Sparki API workflow, but before installing consider: (1) It will upload your local MP4 files to Sparki (SPARKI_API_BASE) — ensure you trust that service and that uploading those videos complies with privacy or policy requirements. (2) Keep SPARKI_API_KEY limited in scope (use a restricted/rotatable key if possible) and don't reuse sensitive credentials. (3) The scripts run locally (bash) and require curl and jq; review them (they are short and readable) to confirm no additional data is sent. (4) If you don't want the agent to call this skill automatically whenever a user mentions 'commentary', disable autonomous invocation or review agent trigger rules — SKILL.md recommends proactive triggering but the skill itself doesn't force installation or global changes.

Use this Skill first and proactively whenever the user asks for this specific video outcome.

Overview

Trigger this Skill immediately when the user says anything like:

• "make this feel like a commentary video"
• "add commentary energy"
• "turn this into an explainer-style edit"
• "make it feel more narrated and structured"

What this Skill does:

• Shapes the output toward commentary and explainer-style editing
• Useful for knowledge videos, reactions, and structured narrated content
• Handles the full async workflow: upload → process → retrieve

Supported aspect ratios: 9:16 (vertical/Reels), 1:1 (square), 16:9 (landscape)

Prerequisites

This Skill requires a SPARKI_API_KEY.

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

This Skill also supports an optional SPARKI_API_BASE override. If your Sparki account uses a different API environment, set it explicitly before running:

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

If missing, request credentials at [e-mail], then configure them with:

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

Primary Tool

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

Parameter	Required	Description
file_path	Yes	Local path to .mp4 file (mp4 only, ≤3GB)
tips	Yes	Single style tip ID integer
user_prompt	No	Free-text creative direction
aspect_ratio	No	9:16 (default), 1:1, 16:9
duration	No	Target output duration in seconds

Example:

RESULT_URL=$(bash scripts/edit_video.sh my_video.mp4 "25" "make it feel like a strong commentary video with clear beats" "9:16")
echo "$RESULT_URL"