SoulDub Video Translate Skill

이 Skill은 Agent가 다음 작업을 수행하도록 돕습니다.

• 로컬 .mp4 동영상을 SoulDub에 업로드합니다.
• 동영상 번역 작업을 생성합니다.
• 오래 걸리는 번역 작업의 진행률을 추적합니다.
• 번역 영상과 자막을 다운로드합니다.

성공하면 다음 파일이 저장됩니다.

• result.mp4: 번역 영상
• translated.srt: 대상 언어 자막
• bilingual.srt: 이중 언어 자막

공개 GitHub 저장소에서 설치합니다.

npx skills add jiabaogithub/souldub-skills --skill souldub-video-translate

설치 후 로컬 MP4 경로와 대상 언어를 지정해 Agent에게 Skill을 실행하도록 요청하세요.

Use the souldub-video-translate skill to translate C:\path\to\video.mp4 into Japanese.

이 Skill은 Japanese, Chinese, 일본어, 중국어와 같은 지원 언어 이름도 허용합니다.

Agent는 누락된 정보를 확인하고 번역을 시작하며 진행률을 보고하고 작업이 끝나면 로컬 출력 경로를 반환합니다.

이 Skill에는 SoulDub API 키가 필요합니다.

설치 후 Agent에게 인증 상태를 확인하도록 요청하세요.

uv run scripts/video_translation.py auth status

API 키가 구성되지 않은 경우 Skill은 다음 사용자 수준 구성 파일을 생성합니다.

~/.souldub/souldub.config.yaml

파일에 souldub_api_key를 설정하거나 SOULDUB_API_KEY 환경 변수를 설정하세요.

• Python 3.11+
• uv
• SoulDub Agent API 네트워크 액세스
• SoulDub API 키
• 원본 MP4 파일 읽기 권한
• 출력 디렉터리 쓰기 권한

설치된 Skill 파일은 읽기 전용으로 취급됩니다.

실행 상태는 사용자 플랫폼 상태 디렉터리에 저장됩니다. 번역 결과는 원본 영상 옆 souldub_outputs/ 폴더에 저장됩니다.

Skill은 API 키, 업로드용 서명 URL, 미디어 게이트웨이 URL, 임시 서명 매개변수를 저장하지 않습니다.

저장소 구조:

skills/
└── souldub-video-translate/

저장소 루트에서 로컬 검색을 확인합니다.

npx skills add . --list

로컬 작업 사본을 설치합니다.

npx skills add . --skill souldub-video-translate

도우미를 직접 실행해 로컬 디버깅을 수행합니다.

cd skills/souldub-video-translate
uv run scripts/video_translation.py auth status