Communitygithub.com

ChatCut-통합/에이전트-플러그인

Codex가 ChatCut 플러그인(chatcut MCP 서버)을 사용하여 모션 그래픽 JSX 에셋을 추가, 생성, 수동 작성, 패치 또는 배치할 때 사용합니다. 참조 브라우징, 직접 인라인 JSX 작성, 편집 가능한 속성, 에셋 바인딩, 타임라인 배치 및 구성 검증을 포함합니다.

에이전트-플러그인란 무엇인가요?

이 스킬은 AI 에이전트(특히 Codex)가 ChatCut 플러그인 환경 내에서 모션 그래픽(MG)을 생성하고 관리할 수 있도록 설계되었습니다. chatcut MCP(모델 컨텍스트 프로토콜) 서버를 활용하여 인라인 JSX 코드를 통해 MG 에셋을 직접 작성하거나 패치할 수 있게 하며, 이는 사전 정의된 프롬프트나 Gemini 생성 워크플로를 사용하는 대신 더 정밀한 제어를 제공합니다. 이 스킬은 비주얼 스타일 브라우징 및 선택, 기존 디자인 스타일이나 프리셋 적용, 특정 비디오 콘텐츠에 맞춘 MG의 구성 및 배치를 포괄합니다. 또한 여러 에셋을 포함할 수 있는 복잡한 구성을 분할하여 각각을 효과적으로 배치하고, 편집 가능한 속성(텍스트, 색상, 숫자 등)을 노출하여 사용자가 AI가 생성한 후에도 쉽게 수정할 수 있도록 합니다. 이 스킬은 ChatCut Web 편집기와 함께 작동하며, 데스크톱 앱에서만 작동하는 내장 ChatCut 에이전트의 모션 그래픽 생성 워크플로를 대체합니다.

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

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

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

문서

모션 그래픽 생성

플러그인 호스트 및 프로젝트

chatcut MCP 서버와 사용자 편집기 URL 또는 플러그인의 프로젝트 결과에서 가져온 프로젝트 ID를 사용합니다. 이 플러그인은 로컬 개발 URL을 포함한 Web 편집기와 함께 작동합니다. Web 프로젝트에 대해 ChatCut 데스크톱을 열거나 chatcut_desktop을 사용하지 마십시오. chatcut 도구를 사용할 수 없는 경우 연결 실패를 보고하고, 편집기의 네이티브 에이전트에 작업을 대신 제출하지 마십시오.

MG 참조를 디자인 전에 찾기

시각적 방향 찾기 및 확인

프로덕션의 경우 승인된 프로젝트 스타일이나 사용자가 제공한 브랜드/참조를 재사용합니다. 전체 사양이 아직 알려지지 않은 경우 manage_design_style get을 사용합니다. 일상적인 텍스트/배치 편집은 새로운 스타일 선택이나 카탈로그 재검색이 필요하지 않습니다.

새로운 방향이 필요하거나 사용자가 대안을 찾아보라고 요청하는 경우 browse_library references: {view: "style-overview"}로 시작합니다. nextOffset을 따라 complete가 될 때까지 모든 번호가 매겨진 연락처 시트를 읽습니다. 여기에는 게시된 에이전트 지원 스타일 대표자와 연결된 기존 디자인 스타일이 포함됩니다. list_presets는 레거시 카탈로그 하위 집합일 뿐이며 이 시각적 개요를 대체할 수 없습니다. 실패한 페이지를 재시도하고, 완료되지 않은 개요를 조용히 건너뛰는 대신 보고합니다.

음성 리드 비디오의 경우 스타일을 후보로 선정하기 전에 음성 콘텐츠를 이해하고 대표적인 비디오 프레임을 검사합니다. 이미 컨텍스트에 있는 대본 및 프레임 증거를 재사용합니다. 스타일 미리보기와 함께 주제, 전달 톤, 화면 언어, 그리고 푸티지의 색상, 피사체 프레이밍 및 배경을 고려합니다.

시각적 방향이 아직 합의되지 않은 경우 현재 콘텐츠 및 푸티지에 가장 잘 맞는 최대 6개의 뚜렷한 항목을 후보로 선정하고 해당 hero 부분을 읽습니다. 호스트의 widget-forms 스킬을 로드하고 짧은 이름과 함께 실제 heroPreview.url 이미지를 표시합니다. 도구가 반환한 이미지는 에이전트를 위한 증거일 뿐 사용자용 선택기가 아닙니다. 텍스트만으로 선택하면 시각적 차이를 보여줄 수 없습니다. 각 선택 항목을 참조 ID에 매핑하고, 양식의 'Other' 분기를 사용하여 기본 설정 또는 다른 배치를 위해 선택을 반복하거나 별도의 '더 보기' 옵션을 추가하지 마십시오. 사용자가 이미 방향을 선택했거나 스타일 선택을 명시적으로 위임하지 않은 경우 새 스타일을 적용하고 MG를 생성하기 전에 선택을 기다립니다. 'Other' 응답은 수락이 아닙니다.

선택한 스타일 적용

선택한 대표자의 summary, hero 및 members를 읽습니다. designStyleAction을 따라 manage_design_style과 함께:

  • apply_preset: 반환된 presetId를 직접 사용하고, 단지 참조 메타데이터를 저장하기 위해 프리셋을 복제하거나 업데이트하지 마십시오.
  • apply: 기존 저장된 사용자 스타일에 대해 반환된 designStyleId를 재사용합니다.
  • create: 독립적인 참조만 새 사용자 소유 스타일이 필요합니다. 선택한 참조에서 팔레트, 글꼴 및 재사용 가능한 시각적 규칙을 정의하고 저장합니다. 참조의 문서화된 팔레트를 재사용하고, 없는 경우 대표 이미지에서 일관된 팔레트를 도출합니다. designSpec.referenceSources: [{id: "<reference ID>"}]와 개별 heroPreview.url을 thumbnailUrl과 designSpec.images: [{role: "style reference", url: "<heroPreview.url>"}] 모두에 저장합니다. applyToProject: true를 사용하고, 배열을 패치할 때 기존 이미지를 유지합니다.

적용 후, get을 호출하여 새 전체 사양과 소스 ID를 가져오고, 이전 스타일의 캐시된 규칙을 이월하지 마십시오. 새 스타일의 경우 팔레트, 글꼴, 소스, 커버 및 참조 이미지가 저장되었는지 확인합니다. 소스 ID만으로는 이미지가 저장되지 않습니다. 참조 이미지는 시각적 증거이며, 포함할 푸티지/배경이나 재현할 예제 텍스트가 아닙니다.

실제 화면 텍스트(이중 언어 텍스트 및 라틴 숫자 포함)에 따라 fontRecommendations["zh-Hans"] / .en을 사용합니다. 승인된 글꼴 계획을 재사용하고, 빈 언어 그룹은 해결되지 않은 것입니다. 참조의 타이포그래피 특성 및 제목/본문 계층 구조와 일치시키고, 글리프 적용 범위 및 런타임 가용성을 확인합니다. 선택한 제품군/역할을 designSpec.fonts에 저장하고, 언어, 두께, 이탤릭체 및 필수 축을 styleGuide에 저장합니다. 교차 스타일 양식 예제는 이 계획을 대체할 수 없습니다. 누락된 글꼴을 선별하거나 타이포그래피를 명시적으로 조정하는 경우에만 글꼴 매칭을 읽고, 중국어 매칭은 생성된 중국어 효과 이미지에서 시작하며 영어 문자 형태가 아닙니다.

인스턴스를 필요한 MG 형태에 매칭

음성 콘텐츠와 대상 프레임을 사용하여 어떤 MG 형태가 유용한지 결정하고, 참조 미리보기를 통해 해당 선택을 구체화합니다. 비디오 전반에 걸쳐 확인된 시각적 언어를 유지하고, 각 필요한 형태에 적합한 인스턴스를 찾습니다. 사용자가 비교를 요청하지 않는 한 스스로 인스턴스를 선택합니다. 다른 형태는 다른 인스턴스를 사용할 수 있으며, 반복 구성 요소는 검사된 인스턴스를 재사용할 수 있습니다. 반환된 nextReferenceSearch를 따릅니다:

  • 관련 멤버가 있는 경우 kind: "instance", styleId: "<representative UUID>"를 검색하거나 관련 멤버 ID를 읽습니다.
  • 필요한 형태에 적합한 멤버가 없는 경우, 다른 형태가 이미 동일한 스타일 일치를 가지고 있더라도 styleId, facets.style 및 스타일 이름 용어를 생략하고 콘텐츠/형태 query 또는 facets.form으로 전체 인스턴스 라이브러리를 검색합니다.
  • 커버 콜라주를 비교한 다음, parts: ["summary", "hero"]로 선택한 ID를 읽습니다. 애니메이션을 위해 motion을, 구현을 위해 code를 추가합니다. 코드 기반 참조가 templateInspection을 반환하는 경우 저장된 속성 스키마/기본값에 대해 읽기 전용 호출을 사용하고, JSX는 값을 선언하지 않고 props를 읽을 수 있습니다. legacyTemplateRefs는 템플릿 ID입니다. manage_template get은 메타데이터를 읽고 list_assets는 MG 속성을 읽습니다. 둘 다 템플릿을 적용하거나 복사하지 않습니다. inspect_asset은 현재 프로젝트 미디어/MG용이지 카탈로그 소스 ID가 아닙니다.

인스턴스의 구성, 계층 구조, 간격 및 공개 구조를 고정된 프로젝트 글꼴, 팔레트, 재료 및 실제 촬영에 맞게 조정합니다. 더広範한 폼 검색에도 적합한 것이 없으면 스타일 보드를 확장하고 제한 사항을 명시합니다. 관련 세부 정보 읽기를 일괄 처리하고, 하나의 인스턴스를 찾는 것이 관련 없는 폼을 모두 커버하지는 않습니다. 분할 응답의 경우 pendingIds를 따르고, known에는 반환된 버전과 여전히 컨텍스트에 있는 부분만 포함될 수 있습니다. 각 모션 시트는 실제 타임스탬프에서 하나의 디자인이며, 몽타주는 하나의 레이아웃이 아니고 정적 이미지는 애니메이션을 설정하지 않습니다.

새로운/대폭 재설계된 말하는 헤드 오버레이의 경우 오버레이 구성을 읽습니다. 결과에 나타날 materials의 프로덕션 파일만 가져오고 프로젝트 에셋 ID를 사용합니다. 대상 푸티지와 함께 구성된 MG를 검토합니다.

작성 시 참조 사용

구현을 차용할 때 선택한 인스턴스의 code를 읽거나 manage_template list_assets로 연결된 템플릿 속성을 읽습니다. 아래 코드 워크플로에서 프로젝트 스타일을 유지하면서 참조로 사용합니다.

선택한 이미지도 검사하고, URL, ID 또는 검색 결과만으로는 본 참조가 아닙니다. 외관에 대한 STYLE 증거와 구조에 대한 교차 스타일 FORM 증거를 유지합니다. 선택한 참조가 실패하면 재시도하거나 검사했다고 주장하는 대신 누락된 증거를 보고합니다.

이 스킬은 ChatCut 플러그인 작업이 인라인 JSX로 작성 또는 패치된 모션 그래픽 에셋을 요구할 때 사용합니다. 내장 ChatCut 에이전트에는 자체 motion-graphic-gen 워크플로가 있으므로 이 플러그인 작업에서 전환하지 마십시오.

Codex 플러그인 모션 그래픽은 직접 작성됩니다. 새 JSX 에셋에는 create_motion_graphic_from_code를 사용하고 기존 MG JSX에는 edit_asset을 사용합니다. 이 표면은 submit_motion_graphic을 제공하지 않으며, 요청을 Gemini 프롬프트 또는 생성 브리프로 변환하지 마십시오. 직접 작성 도구가 없으면 중지하고 사용할 수 없는 ChatCut 플러그인 도구를 보고합니다.

모션 그래픽 소스를 chatcut MCP 도구를 통해 인라인으로 전달합니다. 도구가 인라인 JSX를 직접 허용하는 경우 ChatCut 저장소, ai-working/, /tmp, 로컬 HTTP 서버, 생성된 코드 파일 또는 추측된 애플리케이션 경로에 코드를 준비하지 마십시오.

핵심 원칙

  • 캔버스 크기, fps, 기존 시각적 언어, 배치 또는 타임라인 충돌이 아직 알려지지 않은 경우 프로젝트 상태를 검사합니다.
  • JSX를 작성하기 전에 코드 작성 전에 필요한 입력을 식별합니다.
  • 사용 가능한 인라인 코드 에셋 워크플로를 통해 모션 그래픽 에셋을 생성하거나 업데이트하고, 정확한 페이로드 모양에 대해 현재 도구 스키마를 사용합니다.
  • 편집에 타임라인 배치가 필요한 경우 타임라인 편집 워크플로를 통해 에셋을 배치하거나 이동합니다.
  • 구조적 또는 시각적 변경 후 프로젝트 상태를 다시 읽고 표시되는 프레임을 확인합니다.

코드 작성 전에

JSX를 작성하기 전에 이 편집에 필요한 정보만 식별합니다:

  • 배치: 시작 시간, 지속 시간, 알려진 경우 대상 레이어, 그래픽이 구성되어야 하는 대상 프레임.
  • 편집에서의 역할: 이 모션 그래픽이 비디오에서 수행하는 작업.
  • 콘텐츠: 반드시 나타나야 하는 정확한 텍스트, 숫자, 미디어 또는 시각적 사실.
  • 타이밍: 내부 모션이 음성, 음악 또는 시각적 이벤트와 동기화되어야 하는지 여부.
  • 시각적 소스: 사용자 제공 스타일, 프로젝트 디자인 스타일, 브랜드 색상/글꼴 또는 승인된 기존 모션 그래픽.
  • 편집 가능한 필드: 속성이 되어야 하는 텍스트, 색상, 숫자, 부울, 이미지 또는 비디오 값.

결과를 실질적으로 변경할 수 있는 누락된 영향력이 큰 입력만 물어보십시오.

시각적 시스템 및 배치

위에서 확인된 전체 디자인 스타일과 검사된 참조를 사용합니다. 새 사용자 지정 방향의 경우 배치 전에 하나의 구성된 결과를 설정하고, 승인된 방향과 일상적인 수정은 스타일 확인을 다시 할 필요가 없습니다.

실제 촬영 및 음성 범위에서 각 구성, 위치, 크기 및 읽기 시간을 선택합니다. 공유 타이포그래피, 팔레트, 재료 및 모션을 유지하면서 참조의 형태를 콘텐츠에 맞게 조정합니다. 고정된 왼쪽/오른쪽 앵커 또는 카드 컨테이너는 구성에서 요구하는 경우에만 적절합니다.

동일한 정보 구조를 가진 의도적으로 반복되는 구성 요소에 대해 항목별 속성을 가진 에셋을 재사용합니다. 새 구조에는 자체 인스턴스 참조와 구성이 필요합니다. 오버레이 경계는 그래픽을 단단히 포함해야 하며, 타임라인 크기는 디자인이 프레임에 걸쳐 보이는 경우에만 사용합니다.

에셋 지속 시간과 내부 비트를 배치된 타임라인 범위와 일치시킵니다. 타이밍이 크게 변경되면 완료되지 않은 애니메이션을 자르는 대신 MG를 업데이트합니다. 배치에 대해 정착된 프레임을 나란히 검토하고, 충돌, 가독성 및 의도하지 않은 반복을 수정한 후 완료를 보고합니다.

편집 가능한 속성

사용자에게 표시되고 변경 가능성이 있는 값을 편집 가능한 속성으로 노출합니다.

  • 표시되는 텍스트, 기본 색상, 강조 색상 및 주요 숫자 값은 속성이어야 합니다.
  • 사용자가 합리적으로 변경할 수 있는 경우 글꼴 선택은 font 속성이어야 합니다.
  • 이미지 및 비디오 소스는 image/video 속성이어야 합니다.
  • 코드 키는 속성 스키마 키와 정확히 일치해야 합니다.
  • item.props에서 값을 읽고, 사용자가 나중에 합리적으로 변경할 수 있는 표시 콘텐츠를 하드코딩하지 마십시오.
  • 동일한 뷰어 작업, 정보 구조 및 시각적 형태를 가진 의도적으로 반복되는 구성 요소에만 항목 수준 속성 재정의를 사용합니다. 이 중 하나라도 다르면 다른 MG 에셋을 만들고 대신 팔레트, 유형 및 모션 로직을 공유합니다.

속성 항목은 안정적인 키, 사용자 대면 레이블, 유형 및 기본값을 선언해야 합니다. 지원되는 속성 유형에는 텍스트, 숫자, 색상, 부울, 선택, 글꼴, 이미지 및 비디오가 포함됩니다.

글꼴

모션 그래픽은 ChatCut 렌더러에서 사용 가능한 글꼴을 사용하여 미리보기와 로컬 내보내기가 일관되게 유지되도록 해야 합니다. STKaiti, PingFang SC, Microsoft YaHei, Arial, Helvetica, Comic Sans MS, system-ui, -apple-system 또는 일반 CSS 제품군과 같은 시스템별 글꼴을 기본 렌더링 글꼴로 사용하지 마십시오. 가용성이 기계마다 다르며 폴백이 발생할 수 있습니다.

글꼴을 선택하거나 교체할 때 search_fonts를 호출하고 반환된 표준 제품군 이름을 fontFamily 값과 일치하는 font 속성 defaultValue로 그대로 사용합니다. 카탈로그에서 반환된 Google Fonts 또는 프로젝트 사용자 지정 글꼴을 사용합니다. 요청된 시스템별 글꼴이 카탈로그에 없는 경우 일관된 로컬 렌더링을 보장할 수 없다고 설명하고, 비슷한 느낌의 지원되는 대안을 검색하여 사용자가 명시적으로 글꼴 폴백을 수락하지 않는 한 사용합니다.

에셋 및 구성

하나의 참조 인스턴스는 여러 타임라인 항목으로 구성된 완전한 구성을 설명할 수 있습니다. 이는 하나의 자체 포함된 MG 에셋을 의미하지 않습니다. 참조 스크린샷, 프로덕션 재료 및 현재 프로젝트 푸티지를 구분합니다.

디자인이 일반 미디어와 그래픽을 결합하는 경우 기본적으로 별도의 항목을 사용합니다:

  • 재사용 가능한 종이/텍스처/배경: 구성 뒤에 있는 이미지 또는 비디오 항목.
  • 현재 프로젝트 사진, 제품 이미지 또는 푸티지: 자체 미디어 항목. 에이전트가 이를 선택/교체, 자르기, 배치 및 지원되는 효과를 적용하고, 사용자가 레이어를 수동으로 조립할 것으로 예상되지 않습니다.
  • 타이포그래피, 모양 및 애니메이션 장식: 투명 MG 항목. 미디어가 그 사이에 있어야 하는 경우 배경 장식과 전경 텍스트를 분리합니다.

작성 전에 레이어 순서, 대상 미디어 사각형, 시작/지속 시간 및 진입 타이밍을 계획합니다. 참조의 사진이나 종이가 다시 생성되지 않도록 MG 브리프/코드 범위에 어떤 레이어가 이미 MG 외부에 존재하는지 명시합니다. 흑백/컬러/그레인을 의도한 미디어 항목에 적용하고 실수로 전경 텍스트에 영향을 주지 않도록 합니다. 실제 재생/내보내기 표면에서 효과 지원을 확인하고, 레이어를 분할하는 것만으로 Web/데스크톱 패리티가 증명되지는 않습니다.

  1. 현재 프로젝트의 browse_assets에서 에셋을 재사용합니다. 출력에 필요한 프로덕션 파일만 내 에셋으로 가져옵니다. asset-import를 로드하고 해당 import_media 세션/업로드 도우미를 사용합니다. 프로젝트 미디어를 등록해도 공개 리소스 라이브러리에 게시되지는 않습니다.
  2. 일반 프로덕션 미디어는 반환된 현재 프로젝트 에셋 ID를 사용하여 edit_item을 통해 배치합니다. 에이전트는 참조의 컴플릿을 사용자 에셋으로 대체하고, 현재 작업의 콘텐츠로 복사 및 데이터를 대체합니다.} }

Individual skills in this repo

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

관련 스킬