Communitygithub.com

ChatCut-Inc/agent-plugin

Seedance, Kling, Gemini Omni, MiniMax H3, MiniMax H3 Max를 통한 AI 비디오 생성. 사용자가 텍스트-투-비디오, 이미지-투-비디오, 첫/마지막 프레임 전환, 참조 기반 생성 등 비디오 클립을 생성하거나 기존 클립을 수정/편집/확장하려 할 때 사용합니다.

agent-plugin란 무엇인가요?

이 스킬은 개발자와 AI 에이전트 사용자가 Seedance, Kling, Gemini Omni, MiniMax H3, MiniMax H3 Max 등 다양한 최첨단 비디오 생성 모델을 활용하여 비디오 클립을 제작, 편집, 확장할 수 있도록 지원합니다. 사용자는 텍스트 설명, 이미지, 첫/마지막 프레임 전환, 참조 가이드를 통해 새로운 비디오를 생성하거나, 기존 생성된 클립을 편집/확장할 수 있습니다. 이 스킬은 ChatCut 플랫폼에서 작동하며, 유료 비디오 생성 크레딧을 필요로 합니다. 주요 워크플로우는 네 단계로 구성됩니다: 사용자와 범위 조정, 프롬프트 작성, 작업 제출 및 확인, 결과 반복. 각 단계에서 사용자 의도에 맞게 모델과 파라미터를 선택하며, 작업 제출 후에는 `track_progress`를 통해 진행 상황을 확인합니다. 모든 모델에 대한 상세한 참조 문서가 포함되어 있어 모델별 기능, 입력 채널, 모드, 프롬프트 구조 및 특별 동작을 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/ChatCut-Inc/agent-plugin/tree/HEAD/claude/skills/video-gen

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

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

문서

비디오 생성

submit_video가 아직 로드되지 않았다면, 호출하기 전에 ToolSearch로 로드하여 실제 파라미터를 추측하지 않고 사용하세요.

호출당 하나의 비디오 생성 작업을 제출하고 jobId를 반환합니다. 작업 상태 및 추후 확인은 track_progress에 속합니다. 이 스킬은 자동으로 비디오를 타임라인에 배치하지 않습니다.

사용 시기

사용자가 비디오 클립을 생성하려 할 때 — 텍스트-투-비디오, 이미지-투-비디오, 첫-마지막 프레임 전환, 참조 기반 생성, 또는 기존 비디오를 생성적으로 편집/확장(소스 클립 기반 새 영상 생성, 타임라인 트리밍 아님).

모델

모델참고 문서장점
seedance-2-5references/seedance25.md기본값. 4-30초, 최대 50개 멀티모달 참조, 오디오 전용 참조, 타임스탬프 제어, mp4/mov 출력 지원. 새 생성, 편집, 확장에 가장 강력한 Seedance 선택.
seedance2references/seedance2.mdSeedance 2.0 전체 모델. 4-15초, 풍부한 멀티모달 참조, 최대 1080p 출력 지원.
seedance2fastreferences/seedance2.mdSeedance 2.0 Fast — seedance2와 동일한 입력 및 4-15초 범위, 약 10분 대신 몇 분 내 반환, 약 20% 저렴, 720p 제한. 사용자가 반복 작업 중이고 최고 품질보다 빠른 처리 시간이 중요할 때 사용합니다.
seedance2minireferences/seedance2.mdSeedance 2.0 Mini — seedance2와 동일한 입력 및 4-15초 범위, 약 50% 저렴, 720p 제한. 전체 모델의 충실도가 필요하지 않은 저렴한 초안 및 대량 배치에 사용합니다.
klingreferences/kling.md프롬프트를 통한 카메라 제어 언어 지원; 캐릭터 샷의 미세한 감정/연기 제어에 강력함. mode:"pro"로 1080p 지원.
minimax-h3references/minimax-h3.mdMiniMax H3. 4-15초, 768p/2k, 첫/마지막 프레임, 최대 9개 이미지 + 3개 비디오 + 3개 오디오 참조(총 12개). 강력한 멀티모달 참조 추종.
minimax-h3-maxreferences/minimax-h3-max.mdMiniMax H3 Max. 5-15초, 480p/768p, 텍스트 또는 첫/마지막 프레임 생성. 참조 모드 또는 2K 출력 미지원.
omnireferences/omni.mdGemini Omni 1.1 Flash. continueFrom을 통한 타겟 편집/확장, 첫/마지막 프레임, 저렴한 360p 초안 지원. 3-10초; 720p 기본값, 1080p/4k 업스케일 지원.

중요: 생성 전에 선택한 모델의 참조 문서를 읽어 기능, 입력 채널, 모드, 프롬프트 구조 및 모델별 동작을 확인하세요.

모델 선택

새 생성의 경우, seedance-2-5가 기본값입니다. 다음 중 하나에 해당할 때만 전환하세요:

  • 사용자가 명시적으로 모델을 지정한 경우 ("用 Kling", "use Kling", "用 Omni", "用 mini", "/kling") — 전환, 재질문 불필요.
  • 사용자가 명시적으로 MiniMax H3를 요청하거나 이미지/비디오/오디오 결합 참조 안내와 2K 출력이 필요한 경우 — minimax-h3 사용.
  • 사용자가 명시적으로 MiniMax H3 Max를 요청하거나 멀티모달 참조 없이 가장 높은 충실도의 텍스트/프레임 생성을 원하는 경우 — minimax-h3-max 사용.
  • Seedance가 명확히 잘 처리할 수 없거나 못하는 경우 — Seedance가 어려움을 겪는 알려진 사례에 해당할 때 kling으로 전환을 제안하고 제출 전 확인.
  • 사용자가 빠르고 저렴한 초안(수정 예정)을 명시적으로 요청한 경우 — omni(360p 초안, ≤10초, 타겟 편집 지원) 제안 후 제출 전 확인.
  • 사용자가 1080p 출력의 Seedance가 필요한 경우 — seedance-2-5 선호; 이 모델과 전체 seedance2가 1080p 지원.
  • 사용자가 Seedance 2.0 입력을 저렴하게 원하거나 한 번에 많은 클립을 원하며 720p에 만족하는 경우 — seedance2mini(4-15초, 2.0 전체 모델 비용의 약 50%) 제안 후 제출 전 확인.
  • 사용자가 2.0 스타일 출력을 반복 작업 중이며 처리 시간에 민감한 경우 — seedance2fast(480p 또는 720p, 4-15초, 2.0 전체 모델 비용의 약 80%, 훨씬 빠른 반환) 제안 후 제출 전 확인.

그 외에는 seedance-2-5를 유지하세요.

기존 클립을 수정하는 경우, 선택은 여기(Step 4)가 아니라 여기서 합니다. 수정 요청은 향후 새 생성의 기본값을 변경하는 이유가 아닙니다. Omni 1.1은 이전 Omni 선택을 대체합니다. omni 별칭을 유지하고 두 번째 레거시 선택을 만들지 마세요.

접근 참고: 8개 모델 모두 ChatCut 유료 비디오 생성 권한(구독 또는 유료 크레딧)이 필요합니다. 구독 장벽에 대한 무료 대안으로 다른 모델을 제시하지 마세요. 사용자가 무료 경로를 요청하면 대신 무료 모션 그래픽 애니메이션을 제공하세요.

도구 파라미터

파라미터값기본값
prompt비디오 설명 (필수)—
modelseedance-2-5, seedance2, seedance2fast, seedance2mini, kling, minimax-h3, minimax-h3-max, omniseedance-2-5
durationSeconds초5
ratio모델 문서 참조16:9
resolution모델별; H3: 768p/2k; H3 Max: 480p/768p; Seedance: 480p/720p/1080p; Omni: 360p/720p/1080p/4k720p (H3 모델: 768p)
outputFormatmp4, mov (seedance-2-5 전용)mp4 (생성); mov (편집/확장)
taskModegenerate, edit, extend (seedance-2-5 또는 omni)generate
name설명적인 에셋 이름 (필수)—
firstFrame프로젝트 에셋 참조—
lastFrame프로젝트 에셋 참조—
continueFrom비디오 에셋 참조 — omni 전용, 편집/확장할 소스—

모델별 파라미터(예: Kling mode, Seedance refImages / refVideos / refAudios) — 모델 참조 문서 참조.

입력 해상도

firstFrame / lastFrame / refImages / refVideos / refAudios 모두 프로젝트 에셋 참조를 사용합니다. browse_assets의 전체 UUID 또는 짧은 접두사를 선호합니다. asset://<id> 및 에셋 도구가 반환한 동일 프로젝트 에셋 URL도 허용됩니다. 슬롯 유형별: 프레임 슬롯 및 refImages → 이미지; refVideos → 비디오; refAudios → 오디오.

외부 URL 및 base64는 허용되지 않습니다. 소스가 공개 URL인 경우, 샌드박스 작업 공간에 다운로드하고 asset-import + push_asset을 통해 로컬 파일을 가져온 후 결과 에셋 ID를 전달하세요.

워크플로우

4단계 루프. 각 새 생성 시 사용자의 의도가 바뀌면 1단계부터 다시 시작하세요.

1단계 — 사용자와 범위 조정

프롬프트를 작성하기 전에 세 가지 차원을 조정하세요:

  1. 길이 및 세그먼트 — 총 길이, 샷 수, 하나의 클립 또는 여러 클립에 포함되는지 여부.

    사용자가 이미 방향을 제시한 경우 ("做一段", "in one video", "分别生成", "split into N shots" 등) — 따르고, 이의를 제기하지 마세요.

    그렇지 않으면 두 가지 경로를 제시하고 사용자가 선택하도록 하세요:

    • 하나의 클립 내 여러 샷 (모델 참조 문서 확인) — 단일 추론, 하위 샷 간 주체/조명/스타일 물리적 일관성; 클립당 길이 제한 내에서 일관된 내러티브에 적합.
    • 여러 클립 — 각 클립을 독립적으로 제어 및 재생성 가능하지만, 아이덴티티와 스타일 연속성은 앵커를 통해 유지해야 함; 길이 제한을 초과하거나 하드 장면 전환에 적합.

    트레이드오프를 제시하고 사용자를 대신해 선택하지 마세요.

  2. 내용 — 각 클립이 묘사하는 내용. 이해한 내용을 세그먼트별로 요약하여 되돌려 주세요. 내용이 모호할 때(예: "춤추는 소녀의 비디오 생성"), 사용자는 일반적으로 다음 중 하나 이상을 지정하지 않았습니다:

    • 주체: 누가/무엇이 주요 주체인가(외모, 옷차림, 특징)?
    • 동작: 무엇을 하고 있는가? (말하기/감정 샷의 경우, 미세 표정은?)
    • 장면: 어디 — 배경, 시간대, 환경 세부 사항?
    • 조명/색상 분위기: 어떤 분위기?
    • 카메라: 샷 크기/각도/움직임 선호도?
    • 스타일: 시각적 스타일 또는 참조(영화적/애니메이션/다큐멘터리/...).

    이 특정 요청에 중요하고 안전하게 추론할 수 없는 항목에 집중하세요 — 이를 빈칸 채우기 연습으로 만들지 마세요. 진행 전에 이해된 부분을 사용자에게 요약하여 되돌려 주세요.

  3. 일관성 앵커 — 여러 샷이 캐릭터, 객체 또는 장면을 재사용하는 경우에만: 샷 간에 고정할 앵커(참조 이미지 또는 비디오)를 식별하세요. 소싱 규칙은 아래 §샷 간 시각적 일관성을 참조하세요.

각 차원에 대해 사용자의 말을 확인하세요:

  • 명확함 — 진행.
  • 모호하거나 누락됨 — 사용자에게 물어보세요. 추측하지 말고, 자신의 해석을 기본값으로 사용하지 마세요. 왕복 확인이 낭비된 생성보다 저렴합니다.

하지 말아야 할 것

  • "말하고 제출" 하지 마세요 — "이것을 2개의 클립으로 만들겠습니다"라고 발표하고 즉시 제출하는 것은 조정이 아니라 발표와 함께 일방적 결정입니다.
  • 단일 비디오 요청을 여러 클립으로 분할하는 것을 기본값으로 하지 마세요. 단일 클립은 여러 하위 샷을 담을 수 있으며(모델 참조 문서 참조), 하위 샷 간 주체/조명/스타일이 물리적으로 일관됩니다. 트레이드오프를 제시하고 사용자가 선택하도록 하세요.
  • 답변이 명백하다고 생각하여 질문을 건너뛰지 마세요.

하드 오버라이드 (사용자의 명시적 말이 우선)

  • "one clip / single clip / 一条 / 一个镜头 / in 1 clip" → 절대 분할하지 마세요. 설명이 객관적으로 길더라도.
  • "N shots / N 段 / N 个镜头" → 정확히 N개 생성.
  • "use this image / 用这张图" → 참조로 사용하고 대체하지 마세요.

2단계 — 프롬프트 작성

선택한 모델의 참조 문서에서 프롬프트 구조 및 파라미터 조합을 확인하세요(예: Seedance의 8요소 구조 및 모드, Kling의 프롬프트 팁). 제출 전에 다음을 확인하세요:

  • name은 설명적인 에셋 이름입니다 — 사용자(및 이후 단계에서의 본인)가 프로젝트 라이브러리에서 이 에셋을 인식할 수 있을 정도로 설명적이어야 합니다. "제목 없음" 또는 "클립 1"과 같은 모호한 이름은 피하세요.
  • 파라미터 조합이 사용자의 의도와 일치하는지 확인하세요 — 모델 참조 문서의 모드 섹션을 참조하세요.
  • 생성된 비디오 오디오는 도구 파라미터가 아닙니다. Seedance와 Kling은 백엔드에서 오디오가 활성화된 상태로 제출됩니다.
  • 유효성 검사 실패 시 오류를 읽고 입력을 수정하세요 — 동일한 잘못된 인수를 맹목적으로 재시도하지 마세요.

3단계 — 하나 제출, 대기, 확인

한 번에 하나의 생성 작업을 제출하세요. 사용자가 명시적으로 여러 클립을 병렬로 요청하지 않는 한, 현재 클립이 완료되고 사용자가 검토할 때까지 다음 클립을 제출하지 마세요. 병렬 제출은 문제를 숨깁니다: 첫 번째 샷이 드리프트 또는 잘못된 프레이밍이 있는 경우, 사용자는 정렬이 잘못된 여러 샷을 폐기하는 것보다 한 번 다시 하는 것을 선호합니다.

  • submit_video.ratio는 생성된 에셋만 제어하며, 프로젝트 타임라인 캔버스는 변경하지 않습니다. 사용자가 최종 출력 종횡비(예: "9:16 세로" 또는 "16:16 가로")를 요청한 경우, 완료된 에셋을 배치하기 전에 manage_timelines action=update(예: ratio:"9:16")로 타임라인 캔버스를 동일한 비율로 설정하세요. 사용자가 검은 막대 없음/전체 화면을 요청한 경우, 캔버스를 설정하거나 시각 항목을 업데이트/추가할 때 fit:"cover"를 전달하세요.
  • 작업 관리를 위해 이 스킬을 사용하지 마세요 — 즉각적인 상태 확인 및 추후 확인 안내를 위해 track_progress를 사용하세요.
  • 제출 후, 후속 작업이 이미 대기 중이지 않는 한 턴을 종료하세요(작업이 생성되었음을 사용자에게 알림).
  • 작업이 완료되면, 다음 샷으로 진행하기 전에 결과를 사용자에게 표시하여 검토를 받으세요.
  • Omni 소스 편집의 경우, 요청된 변경이 성공했다고 주장하기 전에 참조 문서의 첫/중간/끝 프레임 검토를 따르세요.
  • 모델별 실패 처리 — 모델 참조 문서 참조.

4단계 — 반복

사용자가 다음 클립, 수정 또는 연속을 원할 때

…

[번역을 위해 잘림]

Individual skills in this repo

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

관련 스킬