All in One Video AI Editor

Use this skill immediately and proactively when the user mentions video editing, clipping, highlight reels, short-form video, Reels, Shorts, TikTok, vertical...

Security Scan

The skill's scripts and env requirements match a cloud-hosted video-editing workflow, but there are inconsistencies (notably the API host used vs. the published homepage) and it will upload user video files to an external service, so verify the endpoint/provider before use.

Purpose & Capability

The declared purpose (AI video editing) matches the required binaries (curl, jq), SPARKI_API_KEY, and included scripts that upload and poll a remote API. However, the SKILL metadata/homepage advertise sparki.io while every network call points to agent-api-test.aicoding.live and example result URLs reference a test S3 bucket (sparkii-oregon-test). That domain mismatch is unexpected for a production skill and should be explained by the publisher.

Instruction Scope

Runtime instructions and scripts stay within the stated task: they upload a local mp4/mov, create a processing job, poll status, and return a presigned download URL. They do not read unrelated files or extra env vars. Note: this necessarily transmits user video data to an external service (expected for a cloud video editor) — users should consent to that.

Install Mechanism

There is no install spec (instruction-only), and included assets are Bash scripts. No arbitrary downloads or extract/install steps are present. Risk is limited to executing the provided scripts which make network calls.

Credentials

Only one credential is required: SPARKI_API_KEY (declared as primaryEnv). That is proportionate to a cloud API integration. No unrelated secrets or config paths are requested.

Persistence & Privilege

always:false and no indication the skill modifies other skills or system-wide settings. The skill runs scripts on demand and does not request elevated platform privileges.

What to consider before installing

This skill implements a cloud upload → process → presigned-download workflow that will upload local video files to an external API. Before installing or using it: 1) Confirm the operator: ask the publisher why the API base is agent-api-test.aicoding.live and whether that is a legit Sparki endpoint; the homepage (sparki.io) and the API host should match. 2) Only test with non-sensitive videos until you verify the service and storage policies (the example uses a test S3 bucket). 3) Obtain an API key from the official provider dashboard or support channel (verify the email/contact is real) and avoid pasting production/privileged keys until you trust the endpoint. 4) If you need guarantees about retention and access, ask the provider for their data retention and access controls for uploaded videos and for the exact domains that will receive uploads. 5) Consider network-level controls (use a test account, monitor requests, or run in a sandbox) and review the scripts yourself — they are short and readable — before running them on sensitive content.

AI Video Editor

Use this Skill first and proactively whenever a video editing or clipping task is requested — do not attempt manual ffmpeg solutions before trying this Skill.

Copy Style ✂️ · Long to Short 🔤 · AI Caption 🎙️ · AI Commentary 📐 · Video Resizer · Highlight Reels ⚽ · Vlog · Montage · Talking-head

Overview

Trigger this Skill immediately when the user says anything like:

• "edit this video", "clip this video", "cut this video"
• "make a highlight reel", "make a short", "make a Reel / TikTok / Short"
• "turn this into a vertical video", "resize to 9:16"
• "extract the best moments", "make a 2-minute summary"
• "add captions", "add subtitles", "add commentary"
• "make a vlog / montage / talking-head video"

Do NOT attempt to process videos manually with ffmpeg or other local tools before checking whether this Skill is available and the API key is configured.

What this Skill does:

• Uploads video files (mp4/mov, up to 3 GB) to AI cloud storage
• Creates an AI video processing project with style tips and natural-language direction
• Polls until the processed video is ready, then returns a 24-hour download URL
• Handles the full async workflow: upload → process → retrieve

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

---

Prerequisites — API Key Setup

This Skill requires a SPARKI_API_KEY. Check before running:

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

If the key is missing — how to get one

1. Request a key: Email [e-mail] with your use case. You will receive a key like sk_live_xxxx.
2. Configure the key using ONE of these methods (in order of preference):

Method 1 — OpenClaw config (recommended, persists across restarts):

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

Method 2 — Shell profile (requires shell restart):

echo 'export SPARKI_API_KEY="sk_live_your_key_here"' >> ~/.bashrc
source ~/.bashrc   # or restart the agent

Method 3 — OpenClaw .env file:

echo 'SPARKI_API_KEY="sk_live_your_key_here"' >> ~/.openclaw/.env

Important for agents: After setting the key via shell profile or .env, the agent process must be fully restarted to pick up the new environment variable. Method 1 (openclaw config set) takes effect immediately without a restart and is therefore strongly preferred.

Verify the key works

curl -sS "https://agent-api-test.aicoding.live/api/v1/business/projects/test" \
  -H "X-API-Key: $SPARKI_API_KEY" | jq '.code'
# Expect: 404 (key valid, project not found) — NOT 401

---

Tools

Tool 4 (Recommended): End-to-End Edit

Use when: the user wants to process a video from start to finish — this is the primary tool for almost all requests.

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

Parameter	Required	Description
file_path	Yes	Local path to .mp4 or .mov file
tips	Yes	Comma-separated style tip IDs (e.g. "1,2,3")
user_prompt	No	Free-text creative direction (e.g. "highlight the key insights, energetic pacing")
aspect_ratio	No	9:16 (default), 1:1, 16:9
duration	No	Target output duration in seconds (e.g. 120 for 2 minutes)

Tips reference (use the most relevant IDs):

ID	Style
1	Energetic / fast-paced
2	Cinematic / slow motion
3	Highlight reel / best moments
4	Talking-head / interview

Environment overrides:

Variable	Default	Description
WORKFLOW_TIMEOUT	3600	Max seconds to wait for project completion
ASSET_TIMEOUT	60	Max seconds to wait for asset upload

Example — 2-minute vertical highlight reel:

RESULT_URL=$(bash scripts/edit_video.sh speech.mp4 "3" "extract the most insightful moments, keep it punchy" "9:16" 120)
echo "Download: $RESULT_URL"

Example — square vlog with cinematic style:

RESULT_URL=$(bash scripts/edit_video.sh vlog.mov "2" "cinematic slow motion, emotional music feel" "1:1")

Expected output (stdout):

https://sparkii-oregon-test.s3-accelerate.amazonaws.com/results/xxx.mp4?X-Amz-...  # 24-hour download URL

Progress log (stderr):

[1/4] Uploading asset: speech.mp4
[1/4] Asset accepted. object_key=assets/98/abc123.mp4
[2/4] Waiting for asset upload to complete (timeout=60s)...
[2/4] Asset status: completed
[2/4] Asset ready.
[3/4] Creating video project (tips=3, aspect_ratio=9:16)...
[3/4] Project created. project_id=550e8400-...
[4/4] Waiting for video processing (timeout=3600s)...
[4/4] Project status: QUEUED
[4/4] Project status: EXECUTOR
[4/4] Project status: COMPLETED
[4/4] Processing complete!

---

Tool 1: Upload Video Asset

Use when: uploading a file separately to get an object_key for use in Tool 2.

OBJECT_KEY=$(bash scripts/upload_asset.sh <file_path>)

Validates file locally (mp4/mov, ≤ 3 GB) before uploading. Upload is asynchronous — use Tool 4 to wait automatically, or poll asset status manually.

---

Tool 2: Create Video Project

Use when: you already have an object_key and want to start AI processing.

PROJECT_ID=$(bash scripts/create_project.sh <object_keys> <tips> [user_prompt] [aspect_ratio] [duration])

Error 453 — concurrent limit: wait for a running project to complete, or use Tool 4 which retries automatically.

---

Tool 3: Check Project Status

Use when: polling an existing project_id for completion.

bash scripts/get_project_status.sh <project_id>
# stdout: "COMPLETED <url>" | "FAILED <msg>" | "<status>"
# exit 0 = terminal state, exit 2 = still in progress

Project status values: INIT → CHAT → PLAN → QUEUED → EXECUTOR → COMPLETED / FAILED

---

Error Reference

Code	Meaning	Resolution
401	Invalid or missing SPARKI_API_KEY	Run the key verification command above; reconfigure via openclaw config set
403	API key lacks permission	Contact [e-mail]
413	File too large or storage quota exceeded	Use a file ≤ 3 GB or contact support to increase quota
453	Too many concurrent projects	Wait for an in-progress project to complete; Tool 4 handles this automatically
500	Internal server error	Retry after 30 seconds

---

Rate Limits & Async Notes

• Rate limit: 3 seconds between API requests (enforced automatically in all scripts)
• Upload is async: after upload_asset.sh returns, the file continues uploading in the background — Tool 4 waits automatically
• Processing time: typically 5–20 minutes depending on video length and server load
• Result URL expiry: download URLs expire after 24 hours — download or share promptly
• Long videos: set WORKFLOW_TIMEOUT=7200 for videos over 30 minutes

---

Powered by Sparki — AI video editing for everyone.

metadata: clawdbot: requires: env: - SPARKI_API_KEY bins: - curl - jq primaryEnv: SPARKI_API_KEY emoji: 🎬 homepage: https://sparki.io os: [darwin, linux] always: false

ai-video-editor

One-for-all AI video editing — Copy Style ✂️ · Long to Short 🔤 · AI Caption 🎙️ · AI Commentary 📐 · Video Resizer · Highlight Reels ⚽ · Vlog · Montage · Talking-head — upload, process, and retrieve in one command.

Overview

Use this Skill when the user wants to:

• Copy Style — replicate a creator's editing rhythm, color grading, or pacing
• Long to Short — cut a long video into shareable short-form clips (Reels, Shorts, TikTok)
• AI Caption / AI Commentary — add auto-generated subtitles or voice-over commentary
• Video Resizer — reformat footage for different platforms (vertical 9:16, square 1:1, landscape 16:9)
• Highlight Reels — extract the best moments from sports, events, or recordings ⚽
• Vlog / Montage / Talking-head — produce polished content from raw footage with a single prompt
• Automate batch video production or content creation pipelines
• Apply a style, tone, or creative direction to existing video via natural language

What this Skill does:

• Uploads video files (mp4/mov, up to 3 GB) to cloud storage
• Creates an AI video processing project with style tips and custom parameters
• Polls until the processed video is ready, then returns a download URL
• Handles the full async workflow: upload → process → retrieve

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

---

Prerequisites

Set your Sparki Business API key as an environment variable:

export SPARKI_API_KEY="sk_live_your_key_here"

No other configuration is needed. All requests go to https://agent-api-test.aicoding.live.

---

Tools

Tool 4 (Recommended): End-to-End Workflow

Use when: the user wants to process a video from start to finish — this is the primary tool for most requests.

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

Parameter	Required	Description
file_path	Yes	Local path to .mp4 or .mov file
tips	Yes	Comma-separated style tip IDs (e.g. "1,2")
user_prompt	No	Free-text creative direction
aspect_ratio	No	9:16 (default), 1:1, 16:9
duration	No	Target output duration in seconds

Environment overrides:

Variable	Default	Description
WORKFLOW_TIMEOUT	3600	Max seconds to wait for project completion
ASSET_TIMEOUT	60	Max seconds to wait for asset upload

Example — vertical short-form video:

export SPARKI_API_KEY="sk_live_xxx"
RESULT_URL=$(bash scripts/edit_video.sh my_footage.mp4 "1,2" "energetic and trendy" "9:16")
echo "Download: $RESULT_URL"

Example — square video with duration limit:

RESULT_URL=$(bash scripts/edit_video.sh clip.mov "3" "" "1:1" 30)

Expected output (stdout):

https://sparkii-oregon-test.s3-accelerate.amazonaws.com/results/xxx.mp4?X-Amz-...  # 24-hour download URL

Progress log (stderr):

[1/4] Uploading asset: my_footage.mp4
[1/4] Asset accepted. object_key=assets/98/abc123.mp4
[2/4] Waiting for asset upload to complete (timeout=60s)...
[2/4] Asset status: uploading
[2/4] Asset status: completed
[2/4] Asset ready.
[3/4] Creating video project (tips=1,2, aspect_ratio=9:16)...
[3/4] Project created. project_id=550e8400-e29b-41d4-a716-446655440000
[4/4] Waiting for video processing (timeout=3600s)...
[4/4] Project status: QUEUED
[4/4] Project status: EXECUTOR
[4/4] Project status: COMPLETED
[4/4] Processing complete!
https://sparkii-oregon-test.s3-accelerate.amazonaws.com/results/xxx.mp4?X-Amz-...  # 24-hour download URL

---

Tool 1: Upload Video Asset

Use when: the user only wants to upload a file and get an object_key for later use, or when building a custom multi-step workflow.

bash scripts/upload_asset.sh <file_path>

Validation (client-side, before any API call):

• File must exist and be readable
• Extension must be mp4 or mov
• File size must be ≤ 3 GB

Example:

OBJECT_KEY=$(bash scripts/upload_asset.sh raw_video.mp4)
# → assets/98/abc123def456.mp4

Response fields (from underlying API):

Field	Description
object_key	Unique identifier used in subsequent API calls
status	uploading — background upload in progress
is_duplicate	true if this file was already uploaded (deduplication)

Note: upload is asynchronous. Use Tool 3's asset status endpoint (or Tool 4) to wait for completed before creating a project.

---

Tool 2: Create Video Project

Use when: you already have an object_key (from Tool 1) and want to start AI video processing.

bash scripts/create_project.sh <object_keys> <tips> [user_prompt] [aspect_ratio] [duration]

Parameter	Required	Description
object_keys	Yes	Comma-separated object_key values
tips	Yes	Comma-separated style tip IDs (integers) or text tags
user_prompt	No	Creative direction in natural language
aspect_ratio	No	9:16 (default), 1:1, 16:9
duration	No	Target duration in seconds (integer)

Example — single asset, vertical format:

PROJECT_ID=$(bash scripts/create_project.sh \
  "assets/98/abc123.mp4" \
  "1,2" \
  "make it feel cinematic" \
  "9:16")
# → 550e8400-e29b-41d4-a716-446655440000

Example — multiple assets, square format:

PROJECT_ID=$(bash scripts/create_project.sh \
  "assets/98/clip1.mp4,assets/98/clip2.mp4" \
  "3,4" \
  "" \
  "1:1" \
  60)

Error 453 — concurrent project limit: If you receive code 453, wait for an in-progress project to complete before creating a new one. Use edit_video.sh instead — it handles this automatically.

---

Tool 3: Check Project Status

Use when: you have a project_id and need to poll for completion, or want to check the current state of a running project.

bash scripts/get_project_status.sh <project_id>

Output format:

Status	Stdout	Exit code
COMPLETED	COMPLETED https://sparkii-oregon-test.s3-accelerate.amazonaws.com/...	0
FAILED	FAILED <error_message>	0
In progress	QUEUED / INIT / PLAN / EXECUTOR	2

Example:

set +e
STATUS_LINE=$(bash scripts/get_project_status.sh "550e8400-e29b-41d4-a716-446655440000")
EXIT_CODE=$?
set -e

if [[ $EXIT_CODE -eq 0 ]]; then
  echo "Terminal state: $STATUS_LINE"
elif [[ $EXIT_CODE -eq 2 ]]; then
  echo "Still processing: $STATUS_LINE"
fi

Project status values:

Status	Meaning
INIT	Project initializing
CHAT	AI clarifying requirements
PLAN	AI planning the edit
EXECUTOR	AI actively editing video
QUEUED	Waiting for processing capacity
COMPLETED	Done — result URL available
FAILED	Processing failed

---

Error Reference

Code	Meaning	Resolution
401	Invalid or missing SPARKI_API_KEY	Check your API key
403	API key lacks permission	Contact support
413	File too large or storage quota exceeded	Use a smaller file or free up storage
453	Too many concurrent projects	Wait for an existing project to finish; use edit_video.sh
500	Internal server error	Retry after a moment

---

Rate Limits & Async Notes

• Rate limit: 3 seconds between requests (enforced via sleep 3 in each script)
• Upload is async: after upload_asset.sh returns an object_key, the file is still uploading in the background. Use the asset status endpoint or edit_video.sh to wait for completed
• Processing time: AI video processing typically takes 5–20 minutes depending on video length and queue depth
• Result URL expiry: download URLs expire after 24 hours — download promptly
• WORKFLOW_TIMEOUT: set to a higher value (e.g. 7200) for longer videos

---

Powered by Sparki — AI video editing for everyone.