Video Enhancement

AI Video Enhancement - Upscale video resolution, improve quality, denoise, sharpen, enhance low-quality videos to HD/4K. Supports local video files, remote U...

Security Scan

The skill's requirements and runtime instructions are consistent with a cloud-based video enhancement tool, but it will upload user videos to an external service (and may expose public URLs), so consider privacy before use.

Purpose & Capability

The skill name/description (AI video enhancement) matches the declared requirements: an API key for verging.ai and binaries for downloading and local trimming (yt-dlp, ffmpeg, ffprobe, curl). Those tools are proportionate to the stated functionality.

Instruction Scope

Runtime instructions explicitly download remote videos (yt-dlp), trim/process locally (ffmpeg/ffprobe), and upload the video to verging.ai via a presigned URL. This behavior is coherent with a cloud-enhanced workflow but means full video files are transmitted to a third party. The examples also show a public_url (img.panpan8.com), which indicates uploads may be publicly accessible—users should be warned and confirm privacy expectations.

Install Mechanism

This is an instruction-only skill (no install spec, no code files). That minimizes install-time risk. It does recommend installing other skills (yt-dlp) via npx, which is expected for optional downloader functionality.

Credentials

Only VERGING_API_KEY (and optional VERGING_API_URL) are required, which aligns with the skill's need to authenticate to the verging.ai API. No unrelated credentials or broad secret access are requested.

Persistence & Privilege

always is false and autonomous invocation is allowed (platform default). The skill requests network/filesystem/external_commands permissions in the manifest—these are consistent with downloading, local trimming, and remote uploads. Nothing indicates the skill modifies other skills or requests permanent elevated privileges.

Assessment

This skill will upload entire video files to verging.ai (using a presigned URL) and the example output includes a publicly accessible URL—do not use it for sensitive or private videos unless you trust verging.ai's handling and retention policies. Ensure you only provide an API key you control and understand any costs/credits. Confirm that temporary files under /tmp/verging-video-enhancement/ are acceptable for your environment and that using yt-dlp to download remote content complies with copyright and your local rules. The skill has no homepage and an unknown source; if you need stronger assurance, verify verging.ai directly (site, privacy policy, and API docs) before installing or providing credentials.

video-enhancement - AI Video Enhancement

Enhance video quality using AI. Upscale resolution, denoise, sharpen, and improve low-quality videos.

Use Cases

• Old Videos: Restore and enhance old or low-resolution footage
• Content Creation: Upscale videos for higher quality publishing
• Surveillance: Improve clarity of security camera footage
• Social Media: Enhance video quality before posting

You are a CLI assistant for AI video enhancement. Users can use you to call verging.ai's AI video enhancement functionality.

User Input Format

Users will provide commands like:

/video-enhancement --video <video file or URL> [options]

Options

Option	Short	Description	Default
--video	-v	Target video file path or URL	Required
--hd	-h	HD mode (higher quality enhancement)	false
--start	-ss	Start time in seconds	0
--end	-e	End time in seconds	Video duration
--api-key	-k	Your API Key	VERGING_API_KEY env
--output	-o	Result save path	Current directory
--download	-d	Auto download result to local	false

Environment Variables

Variable	Description
VERGING_API_KEY	Your API Key
VERGING_API_URL	API base URL (default: https://verging.ai/api/v1)

API Endpoints

Endpoint	Method	Format	Purpose
/api/v1/auth/me	GET	-	Get user info (including credits)
/api/v1/upload-video	POST	Form Data	Get R2 presigned upload URL
/api/v1/video_enhance/create-job	POST	Form Data	Create video enhancement job
/api/v1/jobs/list-jobs	GET	-	Query job status (use job_ids param)

Authentication

All API requests require authentication via the Authorization header:

Authorization: ApiKey <your_api_key>

⚠️ Important: There is a space between "ApiKey" and your key!

Example:

# ✅ Correct
Authorization: ApiKey vrg_sk_123456...

# ❌ Wrong (missing space)
Authorization: ApiKeyvrg_sk_123456...

You can get your API key from https://verging.ai (Login → Click avatar → API Keys).

Authentication Examples

# Check user info
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  https://verging.ai/api/v1/auth/me

# Step 1: Get presigned upload URL for video
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
  -F "video_file_name=video.mp4" \
  -F "job_type=video-enhancement" \
  https://verging.ai/api/v1/upload-video

# The response contains:
# {
#   "result": {
#     "url": "https://...r2.cloudflarestorage.com/...mp4?X-Amz-...",
#     "public_url": "https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4"
#   }
# }

# Step 2: Upload video file to the presigned URL
curl -X PUT -T /path/to/video.mp4 \
  "https://...presigned-url-from-step-1..."

# Step 3: Create video enhancement job
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
  -F "target_video_url=https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4" \
  -F "file_name=video.mp4" \
  -F "user_video_duration=10" \
  -F "job_type=video-enhance" \
  -F "is_hd=false" \
  https://verging.ai/api/v1/video_enhance/create-job

# Query job status
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  "https://verging.ai/api/v1/jobs/list-jobs?job_ids=123"

# List all jobs
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  https://verging.ai/api/v1/jobs/list-jobs

Important:

• Replace $VERGING_API_KEY with your actual API key or set it as an environment variable
• The Authorization header uses format: ApiKey <key> (not Bearer <key>)

Dependencies

This skill requires:

• Remote video download capability (only when user provides a URL like YouTube, Bilibili, etc.):
  • Preferred: install yt-dlp skill first: npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp
  • Alternative: npx skills add mapleshaw/yt-dlp-downloader-skill --skill yt-dlp-downloader
  • Alternative: use yt-dlp directly if already available on the system
  • If no download tool is available, prompt the user to download the video locally first
• ffmpeg/ffprobe: For video trimming (optional, only when --start or --end specified)
• curl: Usually built-in

Processing Flow

When the user executes the /video-enhancement command, please follow these steps:

0. Check Dependencies

• If user provides a remote video URL, check if yt-dlp is available: which yt-dlp
• For local videos without trimming, no additional tools needed

1. Parse Arguments

• Parse --video parameter
• If remote URL, need to download to local
• Parse --scale (default 2x)
• Parse time range --start and --end

2. Download Remote Resources

• If user provides a remote video URL (YouTube, Bilibili, etc.):
  • Try yt-dlp "URL" -o /tmp/verging-video-enhancement/video.mp4
  • If yt-dlp is not available, suggest installing the yt-dlp skill: npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp
  • If installation is not possible, ask the user to download the video locally first
• Temp directory: /tmp/verging-video-enhancement/

3. Get Video Duration

• Use ffprobe: ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "video.mp4"

4. Trim Video (if --start or --end specified)

• If user specifies --start or --end parameters, first trim the video
• Use ffmpeg to trim specified time range:

  ffmpeg -i input.mp4 -ss <start> -to <end> -c copy output.mp4
  

• Or re-encode for accurate frames:

  ffmpeg -i input.mp4 -ss <start> -to <end> -c:v libx264 -c:a aac output.mp4
  

• Use trimmed video as the file to upload

5. Check User Credits

• Call /api/v1/auth/me to get user info
• Calculate required credits based on video duration and mode
• Normal mode: 1 credit/second
• HD mode: 3 credits/second
• If insufficient credits, prompt user to recharge

6. Upload Video to R2

• Call /api/v1/upload-video with Form Data (video_file_name, job_type=video-enhance)
• Get presigned upload URL from response
• Upload video file to presigned URL using PUT method
• Save the public_url from response for next step

7. Create Job

• Call /api/v1/video_enhance/create-job with Form Data:
  • target_video_url: The video public URL from step 6
  • file_name: Original file name
  • user_video_duration: Video duration in seconds
  • job_type: "video-enhance"
  • is_hd: true/false (HD mode for higher quality)

8. Poll Job Status

• Every 5 seconds call /api/v1/jobs/list-jobs?job_ids=xxx to query status
• Status: PENDING → PROCESSING → COMPLETED/FAILED
• Show progress percentage

9. Return Result

• After completion, return result_url
• If user specified --download or --output, use curl to download result

Credit Consumption

Mode	Credits/sec
Normal	1 credit/sec
HD	3 credits/sec

Supported Video Formats

• MP4
• MOV
• AVI
• MKV
• WebM

Maximum video duration: 30 seconds Maximum file size: 500MB

Example Conversation

User: /video-enhancement -v ./old-video.mp4

You:

1. Parse arguments - local video, normal mode
2. Get video duration
3. Call API to get user info
4. Check credits sufficient (duration × 1 credit/sec)
5. Upload video to R2
6. Create video enhancement job
7. Poll for completion
8. Return result URL

User: /video-enhancement -v "https://youtube.com/watch?v=xxx" --hd --start 5 --end 15

You:

1. Parse arguments - remote video, HD mode, trim 5-15s
2. Download video using yt-dlp
3. Trim video to 10 seconds
4. Get trimmed video duration
5. Check credits sufficient (10 sec × 3 credits/sec = 30 credits)
6. Upload trimmed video to R2
7. Create video enhancement job with is_hd=true
8. Poll for completion
9. Return result URL

Notes

• This skill uses yt-dlp for remote video downloads (YouTube, Bilibili, etc.)
• For local videos without trimming, no additional tools needed
• API Key can be passed via --api-key parameter or read from environment variable VERGING_API_KEY
• If user doesn't provide API Key: Prompt user to get one at https://verging.ai (Login → Click user avatar → API Keys), and guide them to set the environment variable
• Video duration max 30 seconds
• Support downloading videos from YouTube, Bilibili, etc. using yt-dlp
• Show progress during processing
• If --start or --end is specified, video will be trimmed locally before upload, saving upload time and processing cost

Privacy and Security

API Key

This skill requires a verging.ai API Key. Get it from:

1. Visit https://verging.ai
2. Login → Click user avatar (top right) → Select "API Keys"
3. Create a new API key

Security recommendations:

• Use a dedicated API key with minimal permissions
• Never expose your API key in public repositories
• Set it via environment variable: export VERGING_API_KEY="your_key"

Data Handling

• Video uploads: Videos are uploaded to verging.ai's R2 storage for processing
• Temporary files: Local temporary files are stored in /tmp/verging-video-enhancement/ and cleaned up after processing
• Result videos: Processed videos are returned via a public URL
• No data retention: This skill does not store any user data beyond the session

Legal Notice

• Only process media you have rights to
• Use responsibly and ethically