LeoYeAI/agent-master-skills / skills/all-in-one-video-ai-editor
ai-video-editor
UnverifiedUse this skill immediately and proactively when the user mentions video editing, clipping, highlight reels, short-form video, Reels, Shorts, TikTok, vertical video, or asks to process a video file. Do NOT attempt manual ffmpeg work first. Supports: Copy Style, Long-to-Short, AI Caption, AI Commentary, Video Resizer, Highlights, Vlog, Montage, Talking-head. Requires SPARKI_API_KEY (see Prerequisites). If the key is missing, guide the user to obtain one at enterprise@sparki.io and set it via `openclaw config set env.SPARKI_API_KEY <key>`. Powered by https://sparki.io.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 4.5 KB |
| SKILL.md | skill md | 16.3 KB |
| _meta.json | config | 308 B |
| scripts/create_project.sh | script | 3.6 KB |
| scripts/edit_video.sh | script | 5.8 KB |
| scripts/get_project_status.sh | script | 2.4 KB |
| scripts/upload_asset.sh | script | 2.6 KB |
README.md
View on GitHub# ai-video-editor
[](https://clawhub.io)
[](SKILL.md)
[](LICENSE)
> **One-for-all AI video editing.**
> Copy Style βοΈ Β· Long to Short π€ Β· AI Caption ποΈ Β· AI Commentary π Β· Video Resizer Β· Highlight Reels β½ Β· Vlog Β· Montage Β· Talking-head
>
> Upload raw footage, apply AI editing with a natural-language prompt, retrieve a processed video URL β all from a shell script. Powered by [Sparki](https://sparki.io).
---
## What It Does
This ClawHub Skill wraps the [Sparki](https://sparki.io) AI video editing API into four Bash scripts:
| Script | Purpose |
|--------|---------|
| `scripts/upload_asset.sh` | Upload a video file, get an `object_key` |
| `scripts/create_project.sh` | Start AI video processing with style tips |
| `scripts/get_project_status.sh` | Poll project state and retrieve result URL |
| `scripts/edit_video.sh` | **End-to-end**: upload β process β download URL |
**Supported use cases:**
| Scenario | Keywords |
|----------|----------|
| Copy a creator's style | Copy Style, Style Transfer, Aesthetic Match |
| Cut long videos into short clips | Long to Short, Short-form, Reels, Shorts, TikTok, Clips |
| Add subtitles or narration | AI Caption, AI Commentary, Subtitles, Voice-over |
| Reformat for any platform | Video Resizer, Aspect Ratio, Vertical, Square, Landscape |
| Sports / event highlights | Highlight Reels, Sports, Best Moments |
| Daily vlog production | Vlog, Travel, Lifestyle |
| Multi-clip storytelling | Montage, Compilation, Mashup |
| Presenter / interview content | Talking-head, Interview, Explainer |
| Batch automation pipelines | Batch Processing, Content Factory, Automation |
---
## Quick Start
### 1. Install via OpenClaw
```bash
npx clawhub install ai-video-editor --force
```
### 2. Configure API key
```bash
export SPARKI_API_KEY="sk_live_your_key_here"
```
Get your key from the [Sparki Dashboard](https://sparki.io).
### 3. Process a video
```bash
# Full workflow β returns a 24-hour download URL
RESULT_URL=$(bash scripts/edit_video.sh my_video.mp4 "1,2" "energetic and trendy" "9:16")
echo "$RESULT_URL"
```
---
## Requirements
- `bash` 4.x+
- `curl`
- `jq`
- `SPARKI_API_KEY` environment variable
---
## Usage Examples
**Vertical short-form (default):**
```bash
bash scripts/edit_video.sh footage.mp4 "1,2"
```
**Square video with creative direction:**
```bash
bash scripts/edit_video.sh clip.mov "3" "cinematic slow motion" "1:1"
```
**Landscape with duration limit:**
```bash
bash scripts/edit_video.sh raw.mp4 "1" "" "16:9" 60
```
**Step-by-step (manual control):**
```bash
# Upload
OBJECT_KEY=$(bash scripts/upload_asset.sh footage.mp4)
# Create project
PROJECT_ID=$(bash scripts/create_project.sh "$OBJECT_KEY" "1,2" "dynamic" "9:16")
# Poll until done
while true; do
STATUS=$(bash scripts/get_project_status.sh "$PROJECT_ID")
[[ "${STATUS%% *}" == "COMPLETED" ]] && break
sleep 5
done
RESULT_URL="${STATUS#COMPLETED }"
echo "Download: $RESULT_URL"
```
---
## Supported Parameters
| Parameter | Values | Default |
|-----------|--------|---------|
| `aspect_ratio` | `9:16`, `1:1`, `16:9` | `9:16` |
| `duration` | integer (seconds) | β |
| `tips` | comma-separated IDs | required |
| `user_prompt` | free text | β |
**Timeout overrides:**
```bash
WORKFLOW_TIMEOUT=7200 bash scripts/edit_video.sh long_video.mp4 "1"
ASSET_TIMEOUT=120 bash scripts/edit_video.sh large_file.mp4 "2"
```
---
## Error Codes
| Code | Meaning |
|------|---------|
| `401` | Invalid API key |
| `413` | File too large (> 3 GB) or storage full |
| `453` | Concurrent project limit reached |
| `500` | Server error β retry |
---
## Publishing
```bash
# Package for ClawHub
zip -r sparki-video-processor.zip SKILL.md scripts/ README.md
```
Upload via [ClawHub Dashboard](https://clawhub.io) β "Publish New Skill".
Recommended metadata:
- **Category:** `video/ai-generation`
- **Tags:** `video-editing`, `ai`, `content-creation`, `short-form`, `highlight`, `vlog`, `montage`, `caption`, `resizer`
---
Powered by [Sparki](https://sparki.io) β AI video editing for everyone.
---
## Security
- `SPARKI_API_KEY` is passed only via HTTP header β never logged or written to disk
- All user-provided arguments are double-quoted to prevent shell injection
- Scripts make outbound requests only to `agent-api-test.aicoding.live` β no local filesystem writes beyond the uploaded file read
---
## License
MIT β see [LICENSE](LICENSE).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself β your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |