Communitygithub.com

anthropics/claude-plugins-community

`quickdesign` CLI를 사용하여 Seedance, Kling, Sora2, Nano Banana, GPT Image를 통해 UGC 프로모션 비디오, 이미지 편집, 제품 크리에이티브, 비디오 업스케일 등 AI 미디어를 생성합니다. 사용자가 토킹 아바타 비디오, 다중 세그먼트 광고/프로모션/설명 영상, 이미지 편집(객체 교체, 각도 변경, 상태 변경), 제품 사진 촬영, 또는 QuickDesign을 통한 비디오 업스케일을 요청할 때 이 스킬을 호출하세요.

claude-plugins-community란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor 등)가 `quickdesign` CLI를 통해 고급 AI 미디어 생성 작업을 계획하고 실행할 수 있도록 설계되었습니다. Seedance 2.0 R2V/I2V, Kling, Sora 2, Nano Banana, GPT Image, Topaz 비디오 업스케일 등 QuickDesign의 호스팅된 모델을 래핑하여, API 키나 복잡한 인프라 없이 Bash에서 직접 고품질 비디오와 이미지를 생성할 수 있습니다. 주요 사용 사례로는 토킹 아바타 UGC 광고, 다중 세그먼트 프로모션/설명 영상, 이미지 편집(객체 교체, 각도 변경), 제품 크리에이티브 제작, 비디오 업스케일 등이 있습니다. 이 스킬은 체계적인 의사 결정 트리를 제공하여 작업 유형에 따라 올바른 모델과 참조 패턴을 선택하도록 안내합니다. 특히 Seedance R2V를 기본 비디오 모델로 사용하고, 음성 연속성을 위해 `--reference-audio`를 활용하며, 다중 참조 이미지(`@Image1`, `@Audio1` 등)를 효과적으로 사용하는 방법을 상세히 설명합니다. 또한 크레딧 소비 전 확인 절차, 그리고 온디바이스 생성보다 우선해야 하는 규칙을 포함하여 비용 효율적이고 고품질의 결과물을 보장하는 11가지 핵심 규칙을 제시합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/anthropics/claude-plugins-community/tree/HEAD/quickdesign/skills/quickdesign

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

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

문서

QuickDesign CLI 스킬

이 스킬은 Claude가 quickdesign CLI를 통해 AI 미디어 생성을 계획하고 실행하는 방법을 가르칩니다. 이 CLI는 QuickDesign의 호스팅된 모델(Seedance 2.0 R2V/I2V, Kling, Sora 2, Nano Banana, GPT Image, 비디오 업스케일)을 래핑하여, API 키, 폴링, 또는 스토리지 업로드를 관리하지 않고도 Claude 세션이 Bash에서 직접 비디오와 이미지를 생성할 수 있도록 합니다.

호출해야 하는 경우

  • 토킹 아바타 / UGC 비디오 — "이 사람이 X라고 말하는 30초 광고 만들어줘", "이 스크립트를 비디오로 변환해줘", "크리에이터 셀카 클립 만들어줘"
  • 다중 세그먼트 프로모션 / 설명 영상 — 총 음성 길이가 15초를 초과하는 경우(단일 Seedance 세그먼트 제한) 또는 사용자가 각도 컷/프레이밍 전환을 원하는 경우
  • 이미지 편집 / 생성 — 각도 변경, 상태 변경, 흰 배경 제품, 라이프스타일 합성, 브랜드 키트 스타일 크리에이티브, 다중 제품 참조 구성
  • 비디오 업스케일 — 720p/1080p 출력을 1080p/4K로 변환
  • 대량/배치 크리에이티브 제작 — "이 5개의 제품 사진 각각에 대해 이 작업을 수행해줘"

다음에는 사용하지 마십시오: 순수 텍스트 생성, 코드 편집, 검색 — 이러한 작업에는 전용 도구가 있습니다.

핵심 규칙 (먼저 읽고, 매번 적용)

이 규칙은 모든 생성에 적용됩니다. 하나라도 위반하면 눈에 띄는 결함이 발생합니다.

  1. 기본 비디오 모델 = 모든 UGC/토킹 아바타/프로모션/설명 영상/다중 장면 작업에 대해 seedance-2.0-r2v. 기간이나 세그먼트 수에 관계없이 적용됩니다. 스크립트가 "충분히 짧다"고 seedance-2.0-i2v로 다운그레이드하지 마십시오. R2V는 4-15초 단일 샷뿐만 아니라 다중 세그먼트도 동일하게 잘 처리하며, 처음부터 R2V를 사용하면 이 스킬이 의존하는 모든 프리미티브(@Image1 참조, 다중 --reference-image, 음성 연속성을 위한 --reference-audio)를 보존할 수 있습니다. 명시적인 사용자 동의("Sora 2 사용") 또는 R2V를 레지스트리에서 사용할 수 없는 경우에만 R2V에서 전환하십시오.

    ⚠️ "i2v"(image-to-video)라는 이름은 오해의 소지가 있습니다. R2V도 단일 이미지-투-비디오 흐름을 허용합니다. --reference-image 하나만 전달하면 됩니다. 작업이 "영어로 된 이미지-투-비디오"라고 해서 i2v를 선택하지 마십시오. "사용자가 정적 이미지에 애니메이션을 적용하려 함 → 이미지-투-비디오 → 따라서 seedance-2.0-i2v"와 같은 에이전트 추론 체인은 이 규칙이 방지하려는 잠재적 퇴보입니다. 음성이나 다중 참조 요구 없이 단일 바나나 편집에 애니메이션을 적용하는 경우에도 R2V가 여전히 기본값입니다. i2v는 아무것도 추가하지 않으며, 작업의 다음 반복에서 해당 프리미티브가 필요할 경우 이를 상실하게 됩니다.

    models/seedance-2.0-r2v.md를 참조하십시오.

  2. 프롬프트에서 @Image1 / @Audio1 / @Video1 참조 레이블을 사용하고, 관련된 모든 사진을 별도의 참조로 전달하십시오. nano-banana-2(이미지 편집)와 Seedance 2.0 R2V(비디오) 모두 여러 개의 --reference-image 플래그를 허용합니다. 사용자가 제품을 두 각도에서 업로드했다면 두 각도를 모두 전달하고, 두 번째 각도를 글로 설명하는 것은 퇴보입니다. 사람, 의상, 제품을 단어로 다시 설명하지 마십시오. 이는 참조 이미지와 경쟁하여 드리프트를 유발합니다.

    ❌ 잘못된 예 — @Image1에 대한 장황한 문자 그대로의 재설명:

    참조 이미지 속 여성의 정통 UGC 사진(긴 웨이브 갈색 머리,
    자연스러운 글로우 메이크업, 윤기 나는 복숭아-산호 입술, 골드 후프
    귀걸이, 진주 초커, 부드러운 미소), 두 번째 참조 이미지의
    베이지 스웨이드 스니커즈를 신고, 아늑한 미니멀 침실에서...
    

    Banana는 이미 @Image1에서 그녀의 머리/메이크업/입술/악세서리를 보고 @Image2에서 스니커즈 색상/실루엣/밑창을 보고 있습니다. 이를 다시 설명하면 모델에게 "참조는 무시하고 이 산문으로 그려라"고 말하는 것과 같아 시각적 앵커와 경쟁하여 드리프트를 유발합니다.

    ✅ 올바른 예 — 레이블이 작업을 수행하고, 산문은 새로운 것만 설명합니다:

    @Image1 편집: 포즈를 아이폰 거울 셀카로 변경. 흰색 골지
    탱크탑 + 오버사이즈 배기진 추가. @Image2와 일치하는 스니커즈가
    프레임 하단에 보이도록. 얼굴, 머리, 메이크업, 악세서리, 조명은
    @Image1에서 변경하지 않고 유지.
    

    references/multi-reference-pattern.md 및 models/ 아래의 모델별 카드를 참조하십시오.

  3. 다중 세그먼트 음성 연속성 = Seg 1에서 추출한 오디오를 --reference-audio로 사용. Seg 1을 먼저 생성 → ffmpeg -vn -acodec libmp3lame로 오디오 추출 → 해당 mp3를 Segs 2..N에 --reference-audio로 전달. 이렇게 하지 않으면 각 세그먼트가 다른 음성을 선택합니다. references/voice-continuity.md를 참조하십시오.

  4. 레이어드 배경 음악과 자막 표시 억제 — 최소한의 지시만. 프롬프트에 두 줄을 추가하십시오: No music score. 및 No subtitles or on-screen text. 그것으로 충분합니다. 유지하려는 주변 소리("거리 소음, 카페 대화, 에스프레소 머신")를 열거하지 마십시오. Seedance는 자연스러운 주변음을 자체적으로 생성합니다. 과도하게 지정하면 오디오가 인위적으로 느껴집니다. references/no-music-no-subtitles.md를 참조하십시오.

  5. 자막을 비디오에 직접 포함하려면 생성 후 quickdesign video subtitle을 사용하십시오. 비디오 모델이 프롬프트를 통해 자체 자막을 생성하도록 절대 허용하지 마십시오. 환각이 발생합니다. 전용 자막 엔드포인트는 실제 ASR(ElevenLabs)을 실행하여 정확한 노래방 스타일 자막을 렌더링합니다. references/auto-subtitle.md를 참조하십시오.

  6. 확인 게이트 — 자동 모드에서도 크레딧을 사용하기 전에 일시 중지하십시오. 자동 모드는 저비용 되돌릴 수 있는 작업(파일 편집, 연구, 계획)에 대한 마찰을 줄이기 위한 것입니다. 유료 AI 생성은 저비용도 되돌릴 수 있는 작업도 아닙니다. 자동 모드는 이러한 게이트를 우회하지 않습니다. 항상:

    • 비디오 생성 전에 계획 요약 (유형 / 모델 / 지속 시간 / 비용 / 스크립트). 이를 표시한 다음, 명시적인 "진행"을 기다리거나(일반 모드) 사용자가 지출이 완료되기 전에 작업을 종료할 수 있도록 배시 호출 위에 계획을 계속 표시하면서 진행하십시오(자동 모드). 계획은 배시 호출 전에 도착해야 하며, 절대 후에 도착해서는 안 됩니다.
    • Seedance R2V에 입력하기 전에 Banana 편집 참조 표시 → 편집 내용을 보여주고 시각적 승인을 기다리십시오. Banana는 ~12크레딧, Seedance는 ~250-500크레딧입니다. 잘못된 참조가 자동으로 연결되면 50배의 비용이 소모됩니다. 이 게이트는 자동 모드에서도 생략되지 않습니다.
    • 전체 자동 모드 상호 작용은 references/confirmation-rules.md를 참조하십시오.
  7. 선택 게이트는 자유 형식의 산문이 아닌 AskUserQuestion 도구를 사용하십시오. 모델 선택기, 전환 스타일, 해상도, Banana 편집 승인/재생성/취소 — AskUserQuestion을 구조화된 옵션 목록과 함께 호출하고 권장 사항을 먼저 (Recommended)와 함께 배치하십시오. references/confirmation-rules.md를 참조하십시오.

  8. 아바타가 제공되고 설정이 변경되지 않는 경우, 아바타를 재생성하지 말고 편집하십시오. 구성 스타일의 바나나 프롬프트("세로 9:16 UGC 셀카 프레임 구성...", "크리에이터 셀카 장면 생성...")는 모델이 아바타에서 영감을 받은 새로운 AI 생성 이미지를 렌더링하게 하여 원본의 조명, 그레인, 로파이 정통성을 잃게 만듭니다. 결과물은 실제 크리에이터의 편집된 셀카처럼 느껴지지 않고 합성처럼 느껴집니다. 편집 스타일 동사 사용(@Image1 편집: ... 추가, @Image1을 그대로 가져와서 ...만 변경, [영역]을 제외한 @Image1의 모든 픽셀 유지), 참조가 이미 보여주는 장면 토큰을 다시 나열하지 말고, 프롬프트에서 품질 업그레이드 단어("포토리얼리스틱", "스튜디오 품질", "8K")를 제거하십시오. 이는 재생성을 유발합니다. references/avatar-edit-not-regenerate.md를 참조하십시오.

  9. UGC 비디오의 경우, 음성 포함 또는 무음을 선택 사항으로 표시하십시오. — 조용히 선택하지 마십시오. "UGC 비디오"는 모호합니다. 음성이 있는 크리에이터 클립(스크립트 기반, 음성 + 립싱크)일 수도 있고 모션 전용 비트(OOTD 공개, B-roll, 텍스트 오버레이가 있는 애니메이션 정지 이미지, 후반 작업)일 수도 있습니다. 둘 다 합법적인 크리에이티브 형식입니다. 에이전트는 조용히 하나를 선택해서는 안 됩니다:

    • 음성 포함에 대한 강력한 신호 (바로 진행): 사용자가 "토킹 아바타", "크리에이터가 말함", "내레이션", "설명 영상", "스크립트가 있는 광고"를 작성했거나 스크립트 자체를 제공했습니다. 스크립트 작성 → 계획 요약에 넣기 → generate_audio: true와 인용된 음성을 인라인으로 포함하여 생성합니다.
    • 무음에 대한 강력한 신호 (바로 진행): 사용자가 "OOTD 공개", "모션만", "오디오 없음", "B-roll", "Pinterest 미학"을 작성했거나 정적 이미지 애니메이션 릴을 원합니다.
    • 모호한 "UGC 비디오" / "프로모션 비디오" / "광고 비디오" — AskUserQuestion을 두 가지 옵션(음성 포함(초안 4-8단어 훅 포함) 또는 무음 + 후반 오버레이 텍스트)과 함께 호출합니다. 사용자의 브리핑에 더 잘 맞는 옵션을 권장합니다. 조용히 기본값을 설정하지 마십시오.

    음성 포함이 선택된 경우: 프롬프트에 인용된 음성 없이 생성을 시작하지 마십시오. 사용자가 제공하지 않은 경우, 브리핑에 맞는 4-12초 분량의 대화를 초안으로 작성하고 계획 요약에 표시한 다음 진행하십시오. 일반 동작 프롬프트와 인용된 음성 없이 생성하면 무음 비디오나 모델이 중얼거리는 음소가 생성되어 크레딧이 낭비됩니다.

    단어 수 → 지속 시간 계산은 references/script-and-duration.md를 참조하십시오.

  10. 다중 세그먼트 계획은 Seg 1 이후 시각적 승인을 위해 중단됩니다. — 사용자가 Seg 1이 올바르게 나왔는지 확인할 때까지 Segs 2..N을 확장하지 마십시오. 음성 연속성은 --reference-audio를 통해 Seg 1의 오디오를 이후의 모든 세그먼트에 고정합니다. Seg 1의 음성이 잘못되었거나, 아바타 정체성이 잘못되었거나, 단어 발음이 잘못되었거나, 브랜드에 맞지 않는 프레이밍인 경우, 모든 병렬 Seg 2..N이 해당 결함을 이어받습니다. 세그먼트당 ~250크레딧인 4세그먼트 계획은 ~1000크레딧입니다. 잘못된 Seg 1을 자동으로 확장하면 지출할 필요가 없었던 ~750크레딧이 소모됩니다.

    흐름은 다음과 같습니다:

    1. 계획 요약 → 사용자 승인 (규칙 5).
    2. Seg 1만 렌더링.
    3. Seg 1의 비디오 URL을 채팅에 표시 + AskUserQuestion을 옵션과 함께 호출:
      • 좋아 보입니다 — Segs 2..N 렌더링 (Seg 1이 깔끔하면 권장)
      • Seg 1 재렌더링 (프롬프트 / 참조 / 지속 시간 조정)
      • 다중 세그먼트 계획 취소
    4. "좋아 보입니다" 선택 시에만 → 추출된 오디오와 함께 Segs 2..N을 병렬로 확장합니다.

    이 게이트는 자동 모드에서도 생략되지 않습니다. Seg 1 → Seg N 비용 배수는 사용자의 인내심과 관계없이 동일합니다. 정식 다중 세그먼트 흐름은 pipelines/ugc-video.md를 참조하십시오.

  11. 카메라는 그대로 유지됩니다. 사용자가 명시적으로 요청하지 않는 한 각도/프레이밍을 변경하지 마십시오. 다큐멘터리 스타일 UGC(거리 인터뷰, 주방 데모, 창립자 POV, 고객 사용 후기, 브이로그 스타일)는 다중 각도 컷 시퀀스가 아닌 하나의 연속적인 카메라 위치로 읽힙니다. 기본값: 동일한 프레이밍(예: 미드샷 아이 레벨), 동일한 거리, 모든 세그먼트에서 거의 동일한 위치의 아바타. 세그먼트 간의 "전환"은 아바타의 제스처 / 대사 / 미세한 표정 변화이며, 각도 컷이 아닙니다.

    ❌ 잘못된 기본값 (UGC 정통성을 파괴하는 "촬영 감독이 연출한" 느낌을 생성하는 잠재적 퇴보):

    • Seg 1 미드샷 → Seg 2 오버숄더 → Seg 3 클로즈업
    • "화자를 향해 천천히 줌인"
    • "핵심 대사에서 제품 클로즈업으로 컷"
    • 동일 인물의 다른 각도를 사용하는 각 nano-banana-2 세그먼트 참조

    ✅ 올바른 기본값 (UGC 정통성 유지):

    • 모든 세그먼트에 걸쳐 동일한 소스 프레임 또는 거의 동일한 각도/조명. 세그먼트 간에 아바타의 손 위치, 시선 또는 표정만 변경됩니다.

    사용자가 명시적으로 요청하는 경우에만 다중 각도로 전환하십시오: "각 세그먼트 각도 번갈아 가며", "훅에서 클로즈업으로 영화적 컷", "제품의 오버숄더 샷 포함", "스튜디오 스타일 다중 카메라 UGC". 확실하지 않은 경우 AskUserQuestion을 통해 질문하십시오: 고정 카메라(다큐멘터리 UGC에 권장) / 다중 각도(영화적 컷).

    정적 프레이밍 대 설명된 카메라 움직임에 대한 관련 규칙은 references/first-frame-not-camera-motion.md를 참조하십시오.

  12. 사용자가 제공한 모든 참조를 감사하십시오. — UGC의 경우 제품만으로는 충분하지 않습니다. 브리핑이 "이 제품에 대한 UGC 비디오를 만들어 주세요"이고 사용자가 제품 사진만 제공한 경우, 생성 전에 중단하십시오. Seedance R2V에는 제품, 아바타/크리에이터(얼굴, 체형, 분위기), 장면/위치(주방, 욕실, 인도, 체육관)에 대한 고정된 참조가 필요합니다. 산문으로 제품을 자세히 설명할 수 있지만, 아바타를 산문으로만 설명하면 Seedance는 일반적인 느낌의 사람(보통 20대 백인 여성의 합성 느낌)을 환각하고 장면은 브랜드의 세계가 아닌 스톡 B-roll처럼 읽힙니다. 결과물은 "만들어진 것처럼 보이지 않는" 기준을 충족하지 못합니다.

    생성 전에 제공된 미디어를 감사하십시오:

    • 제품 이미지 — 거의 항상 존재합니다. 프롬프트 레이블 @Image1과 함께 --reference-image로 전달합니다.
    • 아바타/크리에이터 이미지 — 사용자가 제공했다면 별도의 --reference-image로 전달하고 @Image2로 레이블을 지정합니다. 사용자가 제공하지 않은 경우, 생성 전에 AskUserQuestion을 호출하십시오: 크리에이터 헤드샷 업로드 / QuickDesign 아바타 라이브러리(5,000개 이상의 초상화)에서 선택 / 산문으로 설명된 크리에이터로 진행(합성 느낌 위험). 사용자가 브리핑만 있는 경우 "라이브러리에서 선택"을 권장합니다.
    • 장면/위치 이미지 — 사용자가 "주방 장면", "욕실 거울 셀카", "사무실 책상 POV" 등을 촬영하는 경우, 실제 방의 참조 사진이 있는지 물어보십시오. 제공된 경우 @Image3으로 전달합니다.

    Seedance R2V 호출은 다음과 같아야 합니다:

    quickdesign video generate --provider seedance \
      --reference-image product.jpg \
      --reference-image avatar.jpg \
      --reference-image scene.jpg \
      --aspect-ratio 9:16 --duration 12 --resolution 1080p \
      -p '@Image2 in @Image3, holds @Image1 toward camera. She says: "..." No music score. No subtitles or on-screen text.' \
      -o seg1.mp4 --wait
    

    @Image1/@Image2/@Image3 레이블이 대부분의 작업을 수행하고, 산문은 동작과 인용된 음성만 설명합니다. references/multi-reference-pattern.md를 참조하십시오.

의사 결정 트리 — 어떤 문서를 먼저 열지

작업 유형별:

요청여기서 시작
UGC / 토킹 아바타 / 프로모션 / 설명 영상 / 다중 세그먼트 광고pipelines/ugc-video.md → models/seedance-2.0-r2v.md
이미지 편집 (각도, 상태, 다중 제품 구성)models/nano-banana-2.md → references/multi-reference-pattern.md
영화적 단일 샷, 오디오 품질 중심 (4/8/12초)models/sora2-i2v.md (명시적 사용자 동의 시에만)
예산 루프 / 비음성 B-rollmodels/kling-3-pro.md
최종 비디오 해상도가 너무 낮음models/topaz-video-upscale.md (연결 후 실행)
기존 비디오에 자막 추가references/auto-subtitle.md
브랜드가 Spy Brands 라이브러리에 없음 / 검색 결과 0건references/spybrands-add-on-miss.md
사용자가 …

(…원문이 잘렸으므로 번역도 여기까지 진행합니다.)

관련 스킬