# Send Auto Clipper to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "auto-clipper",
    "name": "Auto Clipper",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/RuneweaverStudios/auto-clipper",
    "canonicalUrl": "https://clawhub.ai/RuneweaverStudios/auto-clipper",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/auto-clipper",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=auto-clipper",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "_meta.json",
      "config.json",
      "scripts/auto_clipper.py",
      "scripts/run.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "auto-clipper",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T06:12:38.585Z",
      "expiresAt": "2026-05-07T06:12:38.585Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=auto-clipper",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=auto-clipper",
        "contentDisposition": "attachment; filename=\"auto-clipper-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "auto-clipper"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/auto-clipper"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/auto-clipper",
    "downloadUrl": "https://openagent3.xyz/downloads/auto-clipper",
    "agentUrl": "https://openagent3.xyz/skills/auto-clipper/agent",
    "manifestUrl": "https://openagent3.xyz/skills/auto-clipper/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/auto-clipper/agent.md"
  }
}
```
## Documentation

### Description

Automatically create clips and videos from media files in a specified folder. Uses Agent Swarm for intelligent task delegation and supports cron-based scheduling.

### AutoClipper

Automatic Video Clip & Highlight Generator for OpenClaw.

v1.0.0 — Design draft. Automatically scan a folder for media files, create clips/highlights using ffmpeg, and organize output. Cron-ready for scheduled automation.

### Installation

# Add to crontab (crontab -e)
# Run every hour at minute 0
0 * * * * /Users/ghost/.openclaw/workspace/skills/auto-clipper/scripts/run.sh

# Or run daily at 9 AM
0 9 * * * /Users/ghost/.openclaw/workspace/skills/auto-clipper/scripts/run.sh --output daily

### Usage

Screen recording highlights: Auto-clip moments from Loom/obsidian recordings
Meeting recaps: Extract key segments from meeting recordings
Content creation: Batch-process raw footage into short clips
Security camera clips: Pull motion-triggered segments from camera feeds
Gaming highlights: Auto-clip "best of" moments from recordings

# Run once (scan and process)
python3 scripts/auto_clipper.py run

# Dry run (show what would be processed)
python3 scripts/auto_clipper.py run --dry-run

# Force reprocess all files
python3 scripts/auto_clipper.py run --force

# Start continuous watcher (not cron-based)
python3 scripts/auto_clipper.py watch

# Show status
python3 scripts/auto_clipper.py status

### Purpose

AutoClipper enables OpenClaw agents to automatically:

Monitor a watch folder for new media files (videos, screen recordings, camera clips)
Analyze media to understand what's worth clipping (via Agent Swarm delegation)
Generate clips using ffmpeg (highlights, segments, trimmed videos)
Produce compilations by stitching multiple clips together
Schedule runs via cron for fully automated workflows

### Architecture

┌─────────────────────────────────────────────────────────────┐
│                      AutoClipper Skill                       │
├─────────────────────────────────────────────────────────────┤
│  1. Watch Folder (configurable input path)                  │
│         ↓                                                   │
│  2. Media Scanner (find new files, filter by extension)    │
│         ↓                                                   │
│  3. Agent Swarm delegation (analyze → clip strategy)             │
│         ↓                                                   │
│  4. Clip Engine (ffmpeg operations)                         │
│         ↓                                                   │
│  5. Output Organizer (save to output folder, optional SNS)  │
└─────────────────────────────────────────────────────────────┘

### 1. Watch Folder Scanner

Monitors a configured input directory
Filters by file extensions: .mp4, .mov, .mkv, .avi, .webm
Tracks processed files (to avoid re-processing)
Configurable: watchFolder, fileExtensions, processedLog

### 2. Media Analyzer (via Agent Swarm)

Delegates analysis to appropriate model (MiniMax for code/technical, Kimi for creative)
Determines:

Which segments to clip (timestamp ranges)
Clip duration targets
Output format preferences


Returns structured clip plan: [{start, end, label, priority}]

### 3. Clip Engine (ffmpeg)

Trim: Extract segments without re-encoding (fast)
Transcode: Convert to target format/codec
Highlight: Auto-detect "interesting" segments (via scene detection)
Compile: Stitch multiple clips into single video
Overlay: Add watermarks, timestamps, captions

### 4. Output Manager

Organized output folder structure: output/YYYY-MM-DD/
Configurable naming: {original}-{timestamp}-{index}.mp4
Optional: Notify via OpenClaw message (Discord, WhatsApp, etc.)

### 5. Cron Scheduler

Standalone script for cron integration
Configurable schedule: 0 * * * * (hourly), 0 9 * * * (daily at 9am)
Dry-run mode for testing
Lock file to prevent overlapping runs

### Configuration (config.json)

{
  "watchFolder": "~/Downloads/Recordings",
  "outputFolder": "~/Videos/Clips",
  "fileExtensions": [".mp4", ".mov", ".mkv"],
  "processedLog": "logs/processed.json",
  "clipSettings": {
    "defaultDuration": 60,
    "minClipDuration": 10,
    "maxClipDuration": 300,
    "outputCodec": "h264",
    "outputFormat": "mp4"
  },
  "intentRouter": {
    "enabled": true,
    "model": "openrouter/minimax/minimax-m2.5"
  },
  "cron": {
    "schedule": "0 * * * *",
    "enabled": false
  },
  "notifications": {
    "enabled": false,
    "channel": "discord"
  }
}

### Tools Needed

ToolPurposeRequiredffmpegVideo transcoding, trimming, clippingYesffprobeMedia metadata extraction (duration, codec)YesAgent SwarmAnalyze media and determine clip strategyYesOpenClaw messageSend notifications when clips are readyOptionalOpenClaw nodesScreen recording capture (live input)Optionalfile systemWatch folder, output managementYes

### Agent Swarm integration

When AutoClipper finds new media, it delegates analysis:

User task: "Analyze video and suggest clip timestamps for meeting highlights"
→ router.spawn() → sessions_spawn(task, model)
← Returns: [{start: "00:05:30", end: "00:07:45", label: "action item discussion"}, ...]

Prompt template for media analysis:

Analyze this video file: {filename}
Duration: {duration_seconds} seconds
Extract: Key moments worth clipping as short highlights (30-90 seconds each)
Output: JSON array of {start_timestamp, end_timestamp, description}

### Directory Structure

auto-clipper/
├── SKILL.md              # This file
├── _meta.json            # Skill metadata
├── config.json           # Configuration
├── README.md             # Setup instructions
├── scripts/
│   ├── auto_clipper.py   # Main entry point
│   ├── scanner.py        # Watch folder scanner
│   ├── clipper.py        # ffmpeg wrapper
│   ├── analyzer.py       # Agent Swarm integration
│   └── run.sh            # Cron launcher
└── logs/
    └── processed.json    # Track processed files

### Keywords

video, clip, clips, highlight, highlights
trim, cut, extract, segment
ffmpeg, transcode, encode, convert
folder, watch, monitor, automation
cron, schedule, batch, process
screen recording, meeting, recording

### Skill Name Ideas

AutoClipper ✓ (chosen)
ClipForge
MediaMason
VideoHarvest
HighlightHub
ClipStream
MediaSnip
AutoTrim

### Phase 1: Core (MVP)

Folder scanner with extension filtering
 Basic ffmpeg trim operation
 Simple processed file tracking
 CLI entry point

### Phase 2: Intelligence

Agent Swarm integration for clip planning
 Scene detection for auto-highlighting
 Metadata extraction with ffprobe

### Phase 3: Automation

Cron launcher script
 Continuous watcher mode
 Notification system
 Output organization

### Phase 4: Advanced

Multi-clip compilation
 Overlay/watermark support
 Custom clip templates
 Node camera integration

### Notes

Performance: Use -c copy for fast trimming (no re-encode)
Storage: Auto-cleanup processed files or move to archive
Error handling: Skip corrupted files gracefully, log failures
Idempotency: Same input file should not produce duplicate output
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: RuneweaverStudios
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T06:12:38.585Z
- Expires at: 2026-05-07T06:12:38.585Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/auto-clipper)
- [Send to Agent page](https://openagent3.xyz/skills/auto-clipper/agent)
- [JSON manifest](https://openagent3.xyz/skills/auto-clipper/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/auto-clipper/agent.md)
- [Download page](https://openagent3.xyz/downloads/auto-clipper)