Communitygithub.com

visual-story

Visual storytelling을 위한 기술로, 복잡한 내용을 사람들에게 보여주는 모션 설명 영화, 대화형 시스템 지도, 마이크로 애니메이션이 있는 피치 데크 등을 제작합니다.

visual-story란 무엇인가요?

visual-story 기술은 AI 에이전트가 사용자 요청에 따라 복잡한 시스템이나 프로세스를 시각적으로 설명하는 다양한 형태의 콘텐츠를 제작할 수 있도록 지원합니다. 이 기술은 하나의 큰 캔버스 위에 카메라와 장면, 캡션이 있는 모션 설명 영화(motion explainer film), 노드 간 이동이 가능한 대화형 프로세스 맵(interactive map), 마이크로 애니메이션과 전환 효과가 포함된 피치 데크(pitch deck) 등을 포함합니다. 사용자가 '모션 설명 영화를 만들어 줘', '시스템이 어떻게 작동하는지 애니메이션으로 보여줘', '줌인/줌아웃 가능한 시스템 맵' 또는 '전환 효과와 PDF가 있는 피치 데크' 등으로 요청할 때 적합합니다. 프레임 단위 MP4 내보내기, 반응형 전화기 버전, 서브도메인 게시, QR 코드 생성 등 전체 워크플로우를 지원하며, 배치 단위 작업과 사용자 확인을 강조하여 스타일 변경으로 인한 재작업을 방지합니다. 단순한 슬라이드 데크, 정적 다이어그램, 랜딩 페이지, AI 생성 비디오에는 사용하지 않아야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/smixs/visual-story/tree/HEAD

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

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

문서

Visual story

복잡한 것을 이미지로 보여줍니다: 장면별로, 크게, 설명하는 움직임(장식이 아닌)으로. 캡션은 무슨 일이 일어나고 있는지 말해주고, 캔버스는 그것을 보여줍니다. 모든 작업 배치는 사용자에게 프레임을 보여주고 그들의 "예"를 받는 것으로 끝납니다.

만들고 있는 항목 → 열어야 할 런북

작업런북
설명 영화: 하나의 캔버스에 장면, 카메라, 캡션, "전체 구성" 맵references/motion-film.md
노드 간 점프가 있는 대화형 프로세스 또는 시스템 맵references/scheme.md
마이크로 애니메이션, 전환 효과 및 PDF가 있는 피치 데크references/deck.md
장면이나 카메라가 없는 일반 컨퍼런스 발표일반 슬라이드 데크 워크플로우 사용; deck.md의 가독성 규칙 참고
영화 또는 맵을 MP4로 내보내기references/video-export.md
전화 및 태블릿 버전references/responsive.md
게시, 서브도메인, 비밀번호, QRreferences/publish.md
눈으로 확인: URL별 프레임, 콘택트 시트, 체크리스트references/qa.md
취향 규칙: 색상, 서체, 움직임, 밀도references/taste.md
골격을 복사할 참고 작품references/examples.md

첫 번째 코드 줄 전에 taste.md, examples.md 및 해당 런북을 여십시오. 첫 번째 프리젠테이션 전에 qa.md를 여십시오.

영화인가요, 맵인가요? 영화는 시간에 따라 펼쳐지는 이야기로, 발표자가 장면별로 시청자를 안내합니다. 맵은 시청자가 스스로 탐험하는 하나의 큰 그림입니다. "웨비나를 위해 우리 프로세스를 애니메이션으로 만들어 줘"는 영화이고, "둘러볼 시스템 맵"은 맵입니다. 확실하지 않으면 한 가지 질문을 하세요.

모든 종류에 대한 작업 순서

  1. 사용자의 말로 된 목표, 그런 다음 질문. 한 배치로 물어보고, 권장 옵션을 먼저 제시하며, 아직 답변되지 않은 것만 물으세요: 어떤 참고자료("지난번처럼"), 표시 방식(발표자 클릭 / 자동 재생 / 비디오 / PDF), 스타일(제품 웹사이트), 언어, 데이터(가상 또는 사용자 소스), 마감일 및 화면.
  2. 표 형태의 스크립트 — 장면 또는 슬라이드: 번호, 제목, 한 줄 의미. "예"를 기다리세요.
  3. 파일럿. 하나의 장면 또는 한두 개의 슬라이드를 완전히 완성: 이미지, 움직임, 캡션. 프레임 → 보여주기 → "예"를 기다리세요. 이유: 파일럿에서 찾은 스타일이 다른 모든 것에 전달됩니다. 열두 번째 장면에서 스타일을 찾으면 열두 장면을 다시 해야 합니다.
  4. 2~3개 장면 또는 슬라이드 배치; 각 배치를 보여주고 기다리세요.
  5. 전체 조립: 탐색, 전체 구성 맵 또는 개요, 전화 레이아웃, 게시, QR, PDF 또는 비디오 — 주문된 모든 것.

마감일이 하루 미만인 경우: 파일럿 하나와 "예" 한 번, 나머지는 한 배치로; 표시될 크기(방송 화면, 시청자가 링크를 받는 경우 전화기)에서만 프레임을 확인하세요.

"완료"라고 말하기 전에

  • qa.md의 표시 크기로 프레임을 캡처하고 검토했습니다. 결함은 한 배치로 수정했습니다.
  • 게시가 주문된 경우: 라이브 주소가 새 버전을 제공하고(?v=NN), zbarimg가 QR을 읽습니다.
  • PDF 또는 비디오가 주문된 경우: 파일을 열고 페이지별 또는 프레임별로 검토했습니다.
  • 사용자가 결과를 보고 응답했습니다.
  • 자신의 스크린샷, 브라우저 세션 및 서버 프로세스가 정리되었습니다(pid로 서버 중지).

일반적인 실수

  • 모든 것을 만들어 마지막에 보여주기 → 사용자가 스타일을 변경하여 모든 것을 다시 해야 합니다. 배치 단위로 작업하세요.
  • 작게 만들기: 하나의 큰 아이디어 대신 캔버스에 열 개의 작은 레이블. 이미지는 크게, 코드는 작게.
  • 텍스트로 회피하기: QR 아래에 "전화기로 스캔하세요", "아직 성장 중", "당신은...", 제스처 힌트. 단어 없이 명확한 것은 단어 없이 유지하세요.
  • 장식하기: 카드 가장자리에 색상 강조 줄무늬, 깜박임, "그냥 예쁜". 움직임은 전환을 설명하거나 존재하지 않습니다.
  • 명사와 순간 없이 숫자만("8개 카드") → 시청자는 무엇을 보고 있는지 모릅니다.
  • 적절한 크기의 프레임 없이 "코드를 읽어서" 확인 → 전화기에서는 모든 것이 무너집니다.

관련 스킬