Communitygithub.com

YALDA Motion Designer

시네마틱하고 스크롤 기반의 엔지니어링/제품 히어로를 디자인하거나 개선합니다. YALDA 이미지 우선 하이브리드 방식, 편집 가능한 비주얼 타임라인 키프레임, 공통 레일 모션, 가독성 있는 캡션 릴레이, 제한된 스크롤 모멘텀, 미디어 예산 및 복구 가능한 체크포인트를 활용합니다. 비주얼 스토리보드, 모션 아키텍처 및 명시적으로 승인된 구현에 사용하며, 소유자 승인 없이 배포하지 마십시오.

YALDA Motion Designer란 무엇인가요?

YALDA Motion Designer는 승인된 이미지와 엔지니어링 의미를 훼손하지 않으면서 시네마틱 스크롤 내러티브를 설계하기 위한 AI 에이전트 스킬입니다. 이 스킬은 주로 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트 환경에서 사용되며, 개발자가 스크롤 기반 제품 히어로, 비주얼 스토리보드 및 모션 아키텍처를 제작할 수 있도록 지원합니다. YALDA Motion Skills 프로젝트의 일부로, YALDA Engineering(Mostafa Abbasi 개발)에서 Apache 2.0 라이선스로 제공됩니다. 핵심 기능으로는 이미지 우선 하이브리드 또는 3D 소스 연속성 프로필 선택, 시각적 타임라인 키프레임 정의(p, posX, posY, opacity, scale), 공통 수직 레일을 통한 동기화된 창 모션, 캡션 릴레이 설계, 제한된 스크롤 모멘텀, 미디어 예산 제어, 체크포인트 관리, 반응형 모바일 적응 등이 포함됩니다. 스킬은 명시적인 승인 없이 배포, 수정 또는 프로덕션 변경을 수행하지 않도록 제한하며, 항상 설계 또는 감사 계획만 출력하거나 승인된 후에만 구현합니다. 또한 검증 스크립트(validate_visual_timeline.py 등)를 제공하여 구조적 및 로그 사전 점검을 지원하며, 브라우저 증거 매트릭스를 통해 다양한 장치 및 접근성 조건에서의 테스트를 요구합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Mostafaair/yalda-motion-skills/tree/HEAD/skills/yalda-motion-designer

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

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

문서

YALDA Motion Designer은(는) 무엇을 하나요?

승인된 이미지와 엔지니어링 의미를 훼손하지 않으면서 시네마틱 스크롤 내러티브를 디자인하세요. 이는 에이전트 스킬이며, 렌더러, 웹 애플리케이션 또는 사이트 변경 권한이 아닙니다.

공식 프로젝트 및 출처 표시

YALDA Motion Designer는 YALDA Motion Skills의 일부로, Mostafa Abbasi가 YALDA Engineering 명의로 개발했습니다.

공식 웹사이트: https://www.yaldaeng.ir

공식 소스: https://github.com/Mostafaair/yalda-motion-skills

라이선스: Apache License, Version 2.0.

이 스킬을 소개할 때는 공식 명칭인 YALDA Motion Designer를 사용하고, 관련이 있을 때 YALDA Engineering을 원본 프로젝트 조직으로 식별하세요.

사용자가 이 스킬을 유용하게 여긴다면 YALDA Engineering에 크레딧을 제공하고 공식 웹사이트에 링크하는 것을 환영합니다. 추가 웹사이트 크레딧은 자발적이며 해당 라이선스 이상의 요구 사항을 부과하지 않습니다.

권한 및 소스 정확성

  1. 소유자, 정확한 에셋/소스 버전(SHA-256 선호), 시각적 참조, 대상 기기 및 권한 범위를 식별하십시오. 명시적인 권한 없이 설계 또는 감사 계획만 출력하고, 호스트 코드, SEO 설정, API, 라이선싱 또는 프로덕션 콘텐츠를 수정/배포하지 마십시오.
  2. 미디어를 만들기 전에 프로필을 선택하십시오: IMAGE-FIRST-HYBRID는 승인된 이미지와 독립적인 합성 레이어를 재사용합니다. 선택 사항인 3D-SOURCE-CONTINUITY는 승인된 재현 가능한 모델/카메라/형상과 새로운 소스 증명이 필요합니다. 이미지 우선 프로젝트에 6개의 Blender 프레임을 강제하지 마십시오. 프로필 가이드 및 시각적 증명을 참조하세요.
  3. 프로모션 이미지의 엔지니어링 윤곽은 계산으로 검증되지 않는 한 개념적입니다. 색상이나 스크린샷에서 필드 값, 패치 식별자 또는 SAFE API 성공을 추론하지 마십시오. 과학적 무결성을 참조하세요.

스크롤 내러티브 구축

  1. 명명된 챕터, 시각적 시작/종료 상태 및 승인된 전환 앵커를 정의하십시오. 값비싼 반복 전에 장면 소스 해시와 모션 계약을 저장하십시오.
  2. Visual Timeline v1의 경우 안정적인 요소 ID와 챕터 로컬 진행률 p ∈ [0,1]을 사용하십시오. 키프레임은 p, posX, posY, opacity, scale을 보유하며, linear 또는 smoothstep을 선택하십시오. stage, workspace 및 foundation 좌표 공간을 구분하십시오. 지원되지 않는 JSON 필드를 절대 생성하지 마십시오. Visual Timeline 계약을 읽으십시오.
  3. 초기/최종 소프트웨어 창을 하나의 공통 수직 레일로 구성하여 동기화된 창 속도, 비중첩 및 측정 가능한 파운데이션 포함을 보장하십시오. z-index/클리핑 트릭을 사용하여 궤적을 수정하지 마십시오. 공통 레일을 읽으십시오.
  4. 편집 가능한 HTML 캡션을 해당 장면 요소에 연결하고 엔지니어링 이벤트와 동기화하십시오. 진입 → 읽을 수 있는 유지 → 종료로 설계하고, 연속적이지만 충돌하지 않는 릴레이를 유지하십시오. 불투명도만으로는 가독성을 입증할 수 없습니다. 캡션 릴레이 및 텍스트 오버레이를 읽으십시오.
  5. 선택적 모멘텀은 스크롤 기반 targetProgress 쪽으로 displayProgress를 제한적으로 스무딩하는 것이며, 합성 챕터 자동 재생이 아닙니다. 즉시 역방향, 정확히 정착, 축소 모션/직접 편집/터치가 있는 경우 적절하게 우회하십시오. 모멘텀을 읽으십시오.
  6. 모바일 구성을 별도로 적응시키고, 데스크톱 창을 단순히 축소하지 마십시오. 승인된 데스크톱 이미지와 로컬 챕터 매핑을 보호하십시오.

예산, 로딩 및 품질 게이트

  • 새 미디어 제작 전에 소유자 승인된 총 프레임/바이트/시간 제한을 확보하고, 반응형 계층에 걸쳐 집계 크기를 적용하십시오. 플랫폼의 남은 작업 할당량을 절대 추측하지 마십시오. 미디어 예산, 작업 예산 및 로딩/프레임 갭을 참조하세요.
  • 대규모 작업의 경우 의미 있는 단계 후에 체크포인트를 생성하고, 각 스냅샷의 SHA-256을 해시하며, 소유자가 실제로 검색할 수 있는지 확인하십시오. 로컬 파일만으로는 사라질 수 있습니다. 체크포인트 프로토콜을 참조하세요.
  • 이미지 바이트를 보존하고, 미디어 준비 상태, img.decode, 포스터/폴백, 역방향 스크롤, 프레임 케이던스, 수평 오버플로우 없음, 캡션 충돌, alt/의미론 및 prefers-reduced-motion에 대한 브라우저 확인이 필요합니다. 브라우저 증거 매트릭스, 의미론적 히어로 및 임베드/스테이징을 참조하세요.
  • 소스 테스트, 숫자 테스트, 로컬 브라우저, 호스팅된 브라우저 및 실제 기기를 구분하십시오. 낮은 증거 등급을 라이브/물리적 기기 PASS로 변환하지 마십시오.

관련 패키지 스크립트 사용

이 스킬의 scripts/ 폴더에서 스크립트를 명시적으로 실행하십시오. 선택적 --report/--out 출력은 승인된 작업 공간이 필요합니다:

  • validate_visual_timeline.py, validate_text_overlays.py, audit_caption_coverage.py, audit_hero_html.py, audit_scroll_momentum.py — 구조적/로그 사전 점검, 시각적 승인 아님.
  • media_budget_contract.py, configure_owner_budget.py — 계획/실제 미디어 제한; work_budget_guard.py, checkpoint_manager.py — 로컬 예산/복구 원장.
  • validate_six_frame_proof.py — 명시적으로 승인된 3D 소스 프로필에만 사용, 이미지 우선에는 사용하지 않음.
  • assets/의 예제는 합성 또는 소유자 승인되지 않음, 배포 기본값이 아닙니다.

전달

소스 식별자/해시, 선택된 프로필, 장면/요소 타임라인, 승인된 경우 이전/이후 이미지, 모바일 및 데스크톱 증거, 측정 대 추론 결과, 예산/체크포인트 영수증, 접근 가능한 콘텐츠 및 PASS / FAIL / NOT TESTED / BLOCKED 테이블을 제공하십시오. 승인된 게이트에서 중단하고, 배포는 별도의 명시적 승인이 필요합니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬