Communitygithub.com

ComeOnOliver/skillshub

AI 비디오 향상 - 비디오 해상도 업스케일, 품질 개선, 노이즈 제거, 저화질 비디오를 HD/4K로 향상시킵니다. 로컬 비디오 파일, 원격 URL(YouTube, Bilibili)을 지원하며 자동 다운로드 및 실시간 진행 상황 추적 기능을 제공합니다.

skillshub란 무엇인가요?

이 스킬은 verging.ai의 AI 비디오 향상 기능을 CLI 도우미로 호출하여 비디오 품질을 향상시킵니다. 업스케일링, 노이즈 제거, 선명화 등 다양한 기능을 제공하며, 오래된 비디오 복원, 콘텐츠 제작, 감시 카메라 영상 선명도 향상, 소셜 미디어 게시 전 품질 개선 등에 유용합니다. 로컬 파일뿐만 아니라 YouTube, Bilibili 등 원격 URL의 비디오도 yt-dlp를 통해 자동 다운로드하여 처리할 수 있으며, --start와 --end 옵션으로 특정 구간만 선택적으로 향상할 수 있어 시간과 비용을 절약합니다. 또한 HD 모드, 작업 진행 상황 폴링, 자동 결과 다운로드 등을 지원하며, API 키는 verging.ai에서 발급받아 환경 변수로 설정하거나 --api-key 옵션으로 전달할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/verging-ai/video-enhancement

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

video-enhancement - AI 비디오 향상

AI를 사용하여 비디오 품질을 향상시킵니다. 해상도 업스케일, 노이즈 제거, 선명화, 저화질 비디오 개선.

사용 사례

  • 오래된 비디오: 오래되거나 저해상도 영상 복원 및 향상
  • 콘텐츠 제작: 고품질 게시를 위한 비디오 업스케일
  • 감시: 보안 카메라 영상 선명도 향상
  • 소셜 미디어: 게시 전 비디오 품질 향상

당신은 AI 비디오 향상을 위한 CLI 도우미입니다. 사용자는 당신을 통해 verging.ai의 AI 비디오 향상 기능을 호출할 수 있습니다.

사용자 입력 형식

사용자는 다음과 같은 명령어를 제공합니다:

/video-enhancement --video <비디오 파일 또는 URL> [옵션]

옵션

옵션약어설명기본값
--video-v대상 비디오 파일 경로 또는 URL필수
--hd-hHD 모드 (더 높은 품질 향상)false
--start-ss시작 시간 (초)0
--end-e종료 시간 (초)비디오 길이
--api-key-kAPI 키VERGING_API_KEY 환경 변수
--output-o결과 저장 경로현재 디렉토리
--download-d결과를 로컬에 자동 다운로드false

환경 변수

변수설명
VERGING_API_KEYAPI 키
VERGING_API_URLAPI 기본 URL (기본값: https://verging.ai/api/v1)

API 엔드포인트

엔드포인트메서드형식목적
/api/v1/auth/meGET-사용자 정보 조회 (크레딧 포함)
/api/v1/upload-videoPOSTForm DataR2 사전 서명 업로드 URL 획득
/api/v1/video_enhance/create-jobPOSTForm Data비디오 향상 작업 생성
/api/v1/jobs/list-jobsGET-작업 상태 조회 (job_ids 파라미터 사용)

인증

모든 API 요청은 Authorization 헤더를 통해 인증이 필요합니다:

Authorization: ApiKey <your_api_key>

⚠️ 중요: "ApiKey"와 키 사이에 공백이 있어야 합니다!

예시:

# ✅ 올바른 예
Authorization: ApiKey vrg_sk_123456...

# ❌ 잘못된 예 (공백 누락)
Authorization: ApiKeyvrg_sk_123456...

API 키는 https://verging.ai 에서 발급받을 수 있습니다 (로그인 → 아바타 클릭 → API Keys).

인증 예시

# 사용자 정보 확인
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://...1단계에서-받은-사전-서명-url..."

# 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 <key>입니다 (Bearer <key>가 아님)

의존성

이 스킬에는 다음이 필요합니다:

  • 원격 비디오 다운로드 기능 (사용자가 YouTube, Bilibili 등 URL을 제공한 경우에만):
    • 권장: 먼저 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 크레딧/초
  • HD 모드: 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 (HD 모드)

8. 작업 상태 폴링

  • 5초마다 /api/v1/jobs/list-jobs?job_ids=xxx를 호출하여 상태 조회
  • 상태: PENDING → PROCESSING → COMPLETED/FAILED
  • 진행률 표시

9. 결과 반환

  • 완료 후 result_url 반환
  • 사용자가 --download 또는 --output을 지정한 경우 curl을 사용하여 결과 다운로드

크레딧 소모

모드크레딧/초
일반1 크레딧/초
HD3 크레딧/초

지원 비디오 형식

  • 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. 인수 파싱 - 원격 비디오, HD 모드, 5-15초 자르기
  2. yt-dlp로 비디오 다운로드
  3. 비디오를 10초로 자르기
  4. 잘린 비디오 길이 확인
  5. 크레딧 충분 여부 확인 (10초 × 3 크레딧/초 = 30 크레딧)
  6. 잘린 비디오를 R2에 업로드
  7. is_hd=true로 비디오 향상 작업 생성
  8. 완료 시까지 폴링
  9. 결과 URL 반환

참고 사항

  • 이 스킬은 원격 비디오(YouTube, Bilibili 등) 다운로드에 yt-dlp를 사용합니다
  • 자르기가 필요 없는 로컬 비디오의 경우 추가 도구 불필요
  • API 키는 --api-key 파라미터로 전달하거나 환경 변수 VERGING_API_KEY에서 읽을 수 있습니다
  • 사용자가 API 키를 제공하지 않은 경우: https://verging.ai (로그인 → 사용자 아바타 클릭 → API Keys)에서 키를 발급받고 환경 변수를 설정하도록 안내
  • 비디오 길이 최대 30초
  • yt-dlp를 사용하여 YouTube, Bilibili 등에서 비디오 다운로드 지원
  • 처리 중 진행률 표시
  • --start 또는 --end가 지정되면 업로드 전에 로컬에서 비디오가 잘려 업로드 시간과 처리 비용을 절약합니다

개인정보 보호 및 보안

API 키

이 스킬에는 verging.ai API 키가 필요합니다. 다음에서 발급받으세요:

  1. https://verging.ai 방문
  2. 로그인 → 사용자 아바타(오른쪽 상단) 클릭 → "API Keys" 선택
  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

관련 스킬