Communitygithub.com

ComeOnOliver/skillshub

자막 생성 및 하드코딩. Volcano Engine 전사 → 사전 기반 오류 수정 → 검토 → 하드코딩. 트리거 단어: 자막 추가, 자막 생성, 자막

skillshub란 무엇인가요?

이 스킬은 비디오 파일에서 오디오를 추출하고, Volcano Engine(火山引擎) 음성 인식 서비스를 사용하여 전사한 후, 사전 기반의 맞춤법 및 오류 수정, 수동 검토를 거쳐 최종적으로 자막을 비디오에 하드코딩하는 완전한 자막 생성 워크플로우를 제공합니다. 이는 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용하도록 설계된 '후치' 스킬로, 클립 편집이 완료된 후 호출됩니다. 워크플로우는 약 8~15분 정도 소요되며(수동 검토 시간 포함), 주요 단계로는 오디오 추출 및 업로드, Volcano Engine 전사(사용자 정의 핫워드 포함), AI 에이전트의 자동 교정(사전 정의된 오류 규칙 및 누락된 단어 문제 처리), 수동 검토 서버(로컬 웹 인터페이스를 통해 비디오 재생 및 자막 편집 지원), 마지막으로 FFmpeg를 사용한 자막 하드코딩이 있습니다. 이 스킬은 사용자 정의 사전을 지원하며, 사용자 피드백을 기반으로 지속적으로 업데이트되는 17개 이상의 일반적인 오인식 및 누락된 단어 규칙을 포함하여 음성 인식의 정확도를 크게 향상시킵니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/Ceeon/videocut-skills/%E5%AD%97%E5%B9%95

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

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

문서

자막

전사 → Agent 교정 → 수동 검토 → 하드코딩

핵심 프로세스 (총 약 8-15분, 수동 검토 시간 포함)

1. 오디오 추출 + 업로드          ⏱ ~1분
    ↓
2. Volcano Engine 전사 (핫워드 포함)    ⏱ ~2분
    ↓
3. Agent 자동 교정            ⏱ ~3-5분
    ↓
4. 수동 검토 및 확인              ⏱ 사용자에 따라 다름
    ↓
5. 자막 하드코딩                  ⏱ ~1-2분

Step 1: 오디오 추출 및 업로드

# 오디오 추출
ffmpeg -i "video.mp4" -vn -acodec libmp3lame -y audio.mp3

# uguu.se에 업로드 (임시 파일 호스팅)
curl -s -F "files[][email protected]" https://uguu.se/upload
# 반환 URL 예: https://o.uguu.se/xxxxx.mp3

Step 2: Volcano Engine 전사 (핫워드 포함)

전사 스크립트는 자동으로 사전을 읽어 핫워드로 사용하여 인식 정확도를 높입니다:

# 사전 위치: /Users/chengfeng/Desktop/AIos/클립Agent/.claude/skills/자막/사전.txt
# 스크립트가 자동으로 로드합니다

bash ../剪口播/scripts/volcengine_transcribe.sh "https://o.uguu.se/xxxxx.mp3"

사전 형식 (한 줄에 한 단어):

skills
Claude
Agent
成峰
剪辑skills
claude code

Step 3: Agent 자동 교정

3.1 타임스탬프가 있는 자막 생성

const result = JSON.parse(fs.readFileSync('volcengine_result.json'));
const subtitles = result.utterances.map((u, i) => ({
  id: i + 1,
  text: u.text,
  start: u.start_time / 1000,
  end: u.end_time / 1000
}));
fs.writeFileSync('subtitles_with_time.json', JSON.stringify(subtitles, null, 2));

3.2 Agent 수동 교정 (스크립트 사용 안 함)

전사 후, Agent는 모든 자막을 하나씩 읽고 다음 문제를 수동으로 교정해야 합니다:

일반적인 오인식 규칙 표

오인식정확함유형
成风成峰동음이의어
正特/整特Agent오인식
IT就Agent就발음 유사
edge的叉100Agentx100오인식
cloud codeClaude Code발음 유사
Schill/skillskills발음 유사
剪口拨/剪口波剪口播동음이의어
自净化/资金化自进化동음이의어
减口播剪口播동음이의어
录剪漏剪동음이의어
作为这个做这个동음이의어
斜杠V1/斜杠v/v구어체 표현
斜杠v点口拨/v.口播구어체+동음
a p i t/APIKAPI Key오인식
excuseskills오인식
移完了剪完了동음이의어

일반적인 단어 누락 문제

원문수정설명
步呢是配置第二步呢是配置"第二" 누락
4步就是第4步就是"第" 누락
别省时间特别省时间"特" 누락
这个我们的这个是我们的"是" 누락
在里面看到可以在里面看到"可以" 누락
跟大家处理完跟大家讲完부적절한 단어 선택
剪辑了逻辑剪辑的逻辑문법 오류

3.3 원고 대조 (원고가 있는 경우)

원고/스크립트가 있으면 교정에 도움이 될 수 있지만, 스크립트를 사용한 자동 매칭은 하지 마십시오 (텍스트 차이로 인해 타임스탬프 누적 오류가 발생할 수 있음).

Agent는:

  1. 원고를 참조로 읽기
  2. 수동으로 하나씩 비교하여 차이점 발견 시 수정
  3. 확실하지 않은 부분은 표시하여 수동 검토에 맡기기

Step 4: 검토 서버 시작

cd 자막_디렉토리/
node /path/to/skills/자막/scripts/subtitle_server.js 8898 "video.mp4"

http://localhost:8898 접속

기능:

  • 왼쪽 비디오 재생, 오른쪽 자막 목록
  • 재생 시 현재 자막 자동 강조 표시
  • 자막 텍스트 더블 클릭으로 편집 (타임스탬프 변경 없음)
  • 배속 재생 (1x/1.5x/2x/3x)
  • 자막 저장 / SRT 내보내기 / 자막 하드코딩
  • 하단에 사전 빠른 삽입 표시

Step 5: 자막 하드코딩

기본 스타일: 22px 금색 굵게, 검정색 외곽선 2px, 하단 중앙 정렬

ffmpeg -i "video.mp4" \
  -vf "subtitles='video.srt':force_style='FontSize=22,FontName=PingFang SC,Bold=1,PrimaryColour=&H0000deff,OutlineColour=&H00000000,Outline=2,Alignment=2,MarginV=30'" \
  -c:a copy \
  -y "video_자막.mp4"
파라미터값설명
FontSize22글꼴 크기
FontNamePingFang SC핑팡(PingFang) 글꼴
Bold1굵게
PrimaryColour&H0000deff금색 #ffde00
OutlineColour&H00000000검정색 외곽선
Outline2외곽선 두께
Alignment2하단 중앙 정렬
MarginV30하단 여백

디렉토리 구조

output/YYYY-MM-DD_비디오명/자막/
├── 1_전사/
│   ├── audio.mp3
│   └── volcengine_result.json
├── subtitles_with_time.json    # 핵심 파일
└── 3_출력/
    ├── video.srt
    └── video_자막.mp4

자막 규격

규칙설명
한 화면에 한 줄줄바꿈 없음, 겹치지 않음
문장 끝에 구두점 없음你好 (O), 你好。 (X)
문장 내 구두점 유지先点这里,再点那里 (O)

피드백 기록

2026-01-31

  • Volcano Engine 핫워드 지원, 전사 스크립트에 통합됨
  • Agent는 전사 후 자동 교정을 수행해야 하며, 사용자에게 직접 전달하면 안 됨
  • 자막 스타일: 금색 굵게 #ffde00, 외곽선 2px
  • 'IT'가 자주 Agent로 오인식되므로 오류 수정 규칙 추가 필요
  • 중요: Agent 교정은 수동으로 하나씩 읽어야 하며, 스크립트를 사용한 자동 매칭은 안 됨
  • 일반적인 오인식 규칙 17개 추가 (3.2절 참조)
  • 단어 누락 문제는 오인식보다 발견하기 어려우므로 특히 주의 필요

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

관련 스킬