Communitygithub.com

ComeOnOliver/skillshub

AI 视频增强 - 提升视频分辨率、改善画质、去噪、锐化,将低质量视频增强至高清/4K。支持本地视频文件、远程 URL(YouTube、Bilibili),自动下载、实时进度追踪。

skillshub 是什么?

该技能是一个基于命令行的 AI 视频增强助手,利用 verging.ai 的 API 实现视频画质提升。它支持多种输入方式,包括本地视频文件以及来自 YouTube、Bilibili 等平台的远程 URL,并能自动下载远程视频进行处理。用户通过 `/video-enhancement` 命令配合多种选项(如高清模式、时间裁剪、自定义输出路径)来灵活控制增强过程。处理流程依次为:参数解析、依赖检查、视频下载(若为远程)、可选的时间裁剪、上传至 R2 存储、创建增强任务、轮询进度,最后返回增强后的结果。该技能特别适用于修复老旧视频、提升内容创作质量、改善监控录像清晰度等场景,并内置了权限检查、环境变量配置和进度反馈机制。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/verging-ai/video-enhancement

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

video-enhancement - AI 视频增强

使用 AI 提升视频质量。可提升分辨率、去噪、锐化,改善低质量视频。

使用场景

  • 老旧视频:修复和增强老旧或低分辨率素材
  • 内容创作:提升视频画质以发布更高质量的内容
  • 监控视频:提高安防摄像头录像的清晰度
  • 社交媒体:在发布前增强视频质量

您是 AI 视频增强的 CLI 助手。用户可以通过您调用 verging.ai 的 AI 视频增强功能。

用户输入格式

用户将提供类似如下命令:

/video-enhancement --video <视频文件或URL> [选项]

选项

选项简写描述默认值
--video-v目标视频文件路径或 URL必填
--hd-h高清模式(更高质量的增强)false
--start-ss起始时间(秒)0
--end-e结束时间(秒)视频时长
--api-key-k您的 API 密钥VERGING_API_KEY 环境变量
--output-o结果保存路径当前目录
--download-d自动下载结果到本地false

环境变量

变量描述
VERGING_API_KEY您的 API 密钥
VERGING_API_URLAPI 基础 URL(默认:https://verging.ai/api/v1)

API 端点

端点方法格式用途
/api/v1/auth/meGET-获取用户信息(包括积分)
/api/v1/upload-videoPOSTForm Data获取 R2 预签名上传 URL
/api/v1/video_enhance/create-jobPOSTForm Data创建视频增强任务
/api/v1/jobs/list-jobsGET-查询任务状态(使用 job_ids 参数)

身份认证

所有 API 请求都需要通过 Authorization 头进行身份验证:

Authorization: ApiKey <您的API密钥>

⚠️ 重要:“ApiKey” 和您的密钥之间有一个空格!

示例:

# ✅ 正确
Authorization: ApiKey vrg_sk_123456...

# ❌ 错误(缺少空格)
Authorization: ApiKeyvrg_sk_123456...

您可以从 https://verging.ai 获取您的 API 密钥(登录 → 点击头像 → API 密钥)。

身份认证示例

# 检查用户信息
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  https://verging.ai/api/v1/auth/me

# 步骤 1:获取视频的预签名上传 URL
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

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

# 步骤 2:将视频文件上传到预签名 URL
curl -X PUT -T /path/to/video.mp4 \
  "https://...pre-signed-url-from-step-1..."

# 步骤 3:创建视频增强任务
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

# 查询任务状态
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  "https://verging.ai/api/v1/jobs/list-jobs?job_ids=123"

# 列出所有任务
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  https://verging.ai/api/v1/jobs/list-jobs

重要:

  • 将 $VERGING_API_KEY 替换为您的实际 API 密钥,或将其设置为环境变量
  • Authorization 头使用 ApiKey <密钥> 格式(而不是 Bearer <密钥>)

依赖项

此技能需要:

  • 远程视频下载能力(仅在用户提供 URL 如 YouTube、Bilibili 等时):
    • 推荐:先安装 yt-dlp 技能:npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp
    • 备选:npx skills add mapleshaw/yt-dlp-downloader-skill --skill yt-dlp-downloader
    • 备选:如果系统上已存在,直接使用 yt-dlp
    • 如果没有可用的下载工具,提示用户先本地下载视频
  • ffmpeg/ffprobe:用于视频裁剪(可选,仅在指定 --start 或 --end 时)
  • curl:通常内置于系统中

处理流程

当用户执行 /video-enhancement 命令时,请按以下步骤操作:

0. 检查依赖项

  • 如果用户提供远程视频 URL,检查 yt-dlp 是否可用:which yt-dlp
  • 对于无需裁剪的本地视频,无需额外工具

1. 解析参数

  • 解析 --video 参数
  • 如果是远程 URL,需要下载到本地
  • 解析 --scale(默认 2x)
  • 解析时间范围 --start 和 --end

2. 下载远程资源

  • 如果用户提供远程视频 URL(YouTube、Bilibili 等):
    • 尝试 yt-dlp "URL" -o /tmp/verging-video-enhancement/video.mp4
    • 如果 yt-dlp 不可用,建议安装 yt-dlp 技能:npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp
    • 如果无法安装,请用户先本地下载视频
  • 临时目录:/tmp/verging-video-enhancement/

3. 获取视频时长

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

4. 裁剪视频(如果指定了 --start 或 --end)

  • 如果用户指定了 --start 或 --end 参数,首先裁剪视频
  • 使用 ffmpeg 裁剪指定时间范围:
    ffmpeg -i input.mp4 -ss <start> -to <end> -c copy output.mp4
    
  • 或者为了更精确的帧重新编码:
    ffmpeg -i input.mp4 -ss <start> -to <end> -c:v libx264 -c:a aac output.mp4
    
  • 使用裁剪后的视频作为上传文件

5. 检查用户积分

  • 调用 /api/v1/auth/me 获取用户信息
  • 根据视频时长和模式计算所需积分
  • 普通模式:1 积分/秒
  • 高清模式:3 积分/秒
  • 如果积分不足,提示用户充值

6. 上传视频到 R2

  • 使用 Form Data(video_file_name、job_type=video-enhance)调用 /api/v1/upload-video
  • 从响应中获取预签名上传 URL
  • 使用 PUT 方法将视频文件上传到预签名 URL
  • 保存响应中的 public_url 用于下一步

7. 创建任务

  • 使用 Form Data 调用 /api/v1/video_enhance/create-job:
    • target_video_url:步骤 6 中的视频公共 URL
    • file_name:原始文件名
    • user_video_duration:视频时长(秒)
    • job_type:“video-enhance”
    • is_hd:true/false(高清模式以获得更高质量)

8. 轮询任务状态

  • 每 5 秒调用一次 /api/v1/jobs/list-jobs?job_ids=xxx 查询状态
  • 状态:PENDING → PROCESSING → COMPLETED/FAILED
  • 显示进度百分比

9. 返回结果

  • 完成后,返回 result_url
  • 如果用户指定了 --download 或 --output,使用 curl 下载结果

积分消耗

模式积分/秒
普通1 积分/秒
高清3 积分/秒

支持的视频格式

  • MP4
  • MOV
  • AVI
  • MKV
  • WebM

最大视频时长:30 秒 最大文件大小:500MB

对话示例

用户:/video-enhancement -v ./old-video.mp4

您:

  1. 解析参数 - 本地视频,普通模式
  2. 获取视频时长
  3. 调用 API 获取用户信息
  4. 检查积分是否充足(时长 × 1 积分/秒)
  5. 上传视频到 R2
  6. 创建视频增强任务
  7. 轮询完成
  8. 返回结果 URL

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

您:

  1. 解析参数 - 远程视频,高清模式,裁剪 5-15 秒
  2. 使用 yt-dlp 下载视频
  3. 将视频裁剪为 10 秒
  4. 获取裁剪后的视频时长
  5. 检查积分是否充足(10 秒 × 3 积分/秒 = 30 积分)
  6. 上传裁剪后的视频到 R2
  7. 创建视频增强任务,设置 is_hd=true
  8. 轮询完成
  9. 返回结果 URL

备注

  • 此技能使用 yt-dlp 下载远程视频(YouTube、Bilibili 等)
  • 对于无需裁剪的本地视频,无需额外工具
  • API 密钥可以通过 --api-key 参数传递,或从环境变量 VERGING_API_KEY 读取
  • 如果用户未提供 API 密钥:提示用户在 https://verging.ai 获取密钥(登录 → 点击用户头像 → API 密钥),并指导设置环境变量
  • 视频时长最长 30 秒
  • 支持使用 yt-dlp 从 YouTube、Bilibili 等下载视频
  • 处理过程中显示进度
  • 如果指定了 --start 或 --end,视频将在本地裁剪后再上传,从而节省上传时间和处理成本

隐私与安全

API 密钥

此技能需要 verging.ai API 密钥。获取方式:

  1. 访问 https://verging.ai
  2. 登录 → 点击用户头像(右上角) → 选择“API 密钥”
  3. 创建一个新的 API 密钥

安全建议:

  • 使用具有最低权限的专用 API 密钥
  • 切勿在公共仓库中暴露您的 API 密钥
  • 通过环境变量设置:export VERGING_API_KEY="your_key"

数据处理

  • 视频上传: 视频上传到 verging.ai 的 R2 存储进行处理
  • 临时文件: 本地临时文件存储在 /tmp/verging-video-enhancement/,处理完成后清理
  • 结果视频: 处理后的视频通过公共 URL 返回
  • 无数据保留: 此技能不会在会话之外存储任何用户数据

法律声明

  • 仅处理您拥有权限的媒体
  • 请负责任且合乎道德地使用

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相关技能