Communitygithub.com

데모데이

리포지토리(GitHub 또는 로컬 폴더)와 라이브 웹 앱 또는 네이티브 macOS 앱을 기반으로 매력적인 런칭/데모 비디오를 제작합니다. 스토리보드 작성, 스크립트 녹화, 자동 줌, 자막, 음향 효과를 포함하며 앱 자체 스타일에 맞춰 Remotion에서 MP4로 조립합니다.

데모데이란 무엇인가요?

DemoDay는 GitHub 리포지토리나 로컬 폴더, 그리고 해당하는 라이브 웹 앱 또는 네이티브 macOS 앱을 입력으로 받아 45~75초 길이의 1080p 데모 비디오를 생성하는 Node/TypeScript CLI 도구입니다. 사용자는 영화 감독처럼 스토리보드(`plan.json`)를 작성하고, 도구가 이를 바탕으로 실제 앱을 녹화하고 렌더링합니다. 핵심 강점은 **앱의 디자인 시스템(색상, 글꼴, 마스코트 등)을 자동으로 추출하여 비디오에 적용**함으로써 마치 앱 자체 디자이너가 만든 듯한 일관된 브랜딩을 제공한다는 점입니다. 녹화는 웹 앱의 경우 Playwright를, 네이티브 macOS 앱의 경우 Accessibility API와 ScreenCaptureKit을 사용하여 실제 사용자 상호작용을 캡처하며, 모든 음향 효과는 합성되어 별도의 라이선스가 필요 없습니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 환경에서 사용자가 '데모 비디오', '런칭 비디오', '제품 영상' 등을 요청할 때 실행됩니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/amoveablefeastym/demoday/tree/HEAD

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

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

문서

데모데이은(는) 무엇을 하나요?

리포지토리(GitHub 또는 로컬 폴더)와 라이브 웹 앱 또는 네이티브 macOS 앱을 입력으로 받아 마치 앱 자체 디자이너가 만든 듯한 45~75초 1080p 데모 비디오를 생성합니다. 이 도구는 이 스킬과 함께 제공되는 Node/TS CLI입니다. 당신이 감독입니다. 당신이 스토리보드(plan.json)를 작성하면 도구가 녹화하고 렌더링합니다. API 키가 필요 없습니다.

0. 도구 찾기 및 설정 (TOOL)

TOOL은 이 스킬의 기본 디렉토리입니다. (일반 설치인 경우 package.json이 포함된 전체 리포지토리가 ~/.claude/skills/demoday에 클론됩니다.) 그렇지 않으면 ~/demoday입니다. 둘 다 존재하지 않으면 중단하고 사용자를 README의 설치 단계로 안내하십시오.

머신에서 처음 실행 시 (TOOL/node_modules가 없는 경우):

  1. node --version을 확인하십시오 (≥ 20 필요). 없으면 Node.js를 설치하도록 사용자에게 안내하고 중단하십시오 (brew install node 또는 nodejs.org).
  2. TOOL에서 npm install && npx playwright install chromium을 실행하십시오. 약 300MB를 다운로드하므로 시작 전에 사용자에게 알리십시오.
  3. Mac 앱의 경우 xcrun swiftc --version도 확인하십시오. 없으면 사용자에게 xcode-select --install을 실행하도록 요청하십시오. 헬퍼는 첫 사용 시 스스로 컴파일됩니다.

아래 모든 명령은 TOOL에서 실행됩니다. OUT = out/<소유자>__<리포지토리> (도구가 출력). 비디오는 TOOL/out/ 안에 남아 있으므로 사용자에게 전체 경로를 알려주십시오.

1. 수집

npx tsx src/cli.ts <소유자/리포지토리 또는 github url> [--url <라이브 앱 url>] --prepare

라이브 웹 URL이 필요합니다 (--url, 또는 리포지토리의 홈페이지). 또는 네이티브 macOS 앱의 경우 아래 "네이티브 Mac 앱"을 참조하십시오. 이 명령은 리포지토리를 읽고 앱을 프로브하여 OUT에 다음 파일들을 씁니다: prompt.md (감독 규칙 + README + 매니페스트 + 파일 트리 + 접근성 스냅샷), probe.png (첫 화면 스크린샷), probe.aria.yml.

prompt.md를 읽고 probe.png를 살펴보십시오. src/schema.ts를 읽으십시오. 이것이 plan.json의 정확한 형태이며, 필드 설명이 규칙입니다 (단어 제한, 각 비트가 해야 할 일).

2. 글을 쓰기 전에 스토리 찾기

비디오의 성패는 두 가지에 달려 있습니다: 현 상태가 왜 나쁜지와 이 제품의 특별한 점이 무엇인지.

  • 현 상태: 대상 사용자가 이 제품 없이 오늘날 수행하는 구체적인 작업 흐름. 각 단계의 정직한 시간 비용을 포함하십시오. 경쟁사에 대한 공정한 주장만 하십시오.
  • 특별한 점: 이것을 가능하게 하는 메커니즘 (README/코드에서 파악). 형용사가 아닙니다. "오직 X만 …".
  • README가 과소평가한 기능을 위해 코드를 읽으십시오: 항상 존재하는 데스크톱이나 메뉴 막대 아이콘, 글로벌 핫키, 오프라인/로컬 저장소, 마스코트. 이것들이 종종 실제 차별화 요소입니다. 비디오에 넣기 전에 주장하는 모든 기능을 코드에서 확인하십시오.
  • 사용자가 자신의 포지셔닝, 경쟁사 또는 차별화 요소를 알려줬다면 그들의 것을 사용하십시오. 무엇이 다르게 만드는지 드러나는 것이 없으면 계획을 작성하기 전에 짧은 질문 하나를 하십시오.

3. 앱 스타일 일치 (필수)

비디오는 앱의 일부처럼 보여야 합니다: 동일한 색상, 동일한 글꼴, 동일한 마스코트 또는 아이콘, 동일한 어조. 아늑한 파스텔 앱에 일반적인 어두운 런칭 템플릿(또는 그 반대)은 브랜드에서 벗어난 것으로 읽힙니다. 사용자가 즉시 알아차립니다.

  1. 코드에서 앱의 디자인 토큰 추출:
    • SwiftUI/AppKit: Theme.swift 스타일 파일, Assets.xcassets/*.colorset, Color(hex:) 호출.
    • 웹: CSS 커스텀 속성, tailwind.config.*, 테마 파일, <meta name="theme-color">.
    • 수집: 배경, 텍스트, 카드/패널, 강조, 표시/본문 글꼴.
    • 글꼴: 리포지토리에 번들된 글꼴 파일 선호 (Resources/Fonts/*.ttf, public/fonts, @font-face 소스, next/font/local).
    • 마스코트/아이콘: 스프라이트, 앱 아이콘 (AppIcon.icns → sips -s format png … --out icon.png), 또는 로고 SVG/파비콘.
  2. 앱의 UI에서 분위기를 선택하십시오. 카테고리가 아닙니다. UI가 밝고 따뜻하며 장난기 있거나 미니멀하면 mood: "soft"를 사용하십시오. 앱 자체가 어둡고 기술적이거나 대비가 높으면 bold(기본 어두운 런칭 느낌)를 사용하십시오.
  3. plan.look 채우기:
    "look": { "mood": "soft", "paper": "<앱 배경>", "ink": "<앱 텍스트>", "surface": "<앱 카드>",
              "fontFile": "<리포지토리 글꼴 파일>", "bodyFontFile": "<선택 사항>",
              "motifImage": "<앱 아이콘/마스코트 png/svg>" }
    
    • product.accent를 앱의 강조색으로 설정하되 paper에서 읽을 수 있는 색조로 설정하십시오. 라이트 모드 강조색이 일반적으로 소프트에 적합합니다.
    • 흐릿한 텍스트와 선은 paper/ink에서 자동으로 파생됩니다.
    • 글꼴 파일이 없으면 display(Inter Tight, Pixelify Sans, Fredoka, Nunito)를 사용하십시오. 다른 Google 글꼴을 지원하려면 remotion/lib.ts와 스키마 열거형의 DISPLAY에 추가하십시오.
    • motif: "loaf"는 내장된 픽셀 로프 스프라이트입니다 (베이커리 앱 전용). 그렇지 않으면 motifImage를 사용하십시오.
    • CLI는 이 파일들을 OUT/brand/에 복사합니다. 경로는 절대 경로이거나 로컬 리포지토리에 상대적일 수 있습니다.
  4. 어조를 일치시키십시오: 캡션과 헤드라인에 앱 자체의 마이크로카피와 은유를 차용하십시오 (예: 베이커리 앱의 "반죽 / 부풀리기 / 구움").
  5. 기본적으로 미니멀:
    • 카피 예산: 후크 ≤ 8단어, 기존 방식 약 3단계, 비교 행 3개, 캡션 2~5단어, 필수적인 것 외에는 레이블이나 통계 없음.
    • 너무 많은 단어와 시끄러운 빨간색 경고 스타일링이 최고 불만 사항이었습니다. 소프트 룩은 이미 카운터, 고통 레이블, 흔들림 및 도장을 제거합니다.

4. OUT/plan.json 작성

prompt.md 상단의 감독 규칙을 따르십시오. 녹화 규칙 (newWay.actions):

  • 전체 핵심 루프를 다루십시오. 단 하나의 결과로 가는 최단 경로만이 아닙니다. 사용자는 헤드라인 기능이 누락되면 알아차립니다. 10~20개 동작을 목표로 하고 (최대 20개), 각 기능은 자체 캡션 비트를 가지며, 기존 방식과 동일한 작업을 수행하고 성과로 끝나야 합니다. 웹: 첫 번째 동작은 라이브 URL로 goto입니다.
  • 거의 모든 동작에 캡션을 추가하십시오. 캡션이 없는 비트는 음소거된 시청자에게 침묵으로 읽힙니다.
  • 카메라: 각 동작의 대상 상자에 푸시인됩니다. 대상이 지정되지 않은 fill/press 동작은 포커스가 있는 필드를 조준합니다. 녹화기는 키가 전송된 후 위치를 기록하며, 타이핑 샷은 텍스트 시작 부분에서 2배로 확대됩니다. 캡션은 창 아래 자체 대역에 있으며 앱을 절대 가리지 않습니다. 샷이 잘못된 것을 프레이밍하면 대상을 수정하십시오. 상자를 수동으로 편집하지 마십시오.
  • 선택자는 스냅샷에서 가져옵니다. {role, name}을 있는 그대로 복사하여 사용하는 것을 선호하십시오 (macOS: id, 그다음 placeholder, 그다음 role+name). 코드 편집기 내부의 숨겨진 입력은 괜찮습니다. 녹화기가 표시된 컨테이너를 클릭합니다.
  • 스크립트 깊은 화면은 실제 스냅샷에서 작성하십시오. 추측하지 마십시오:
    1. 해당 화면으로 이동하고 존재하지 않는 id를 클릭하여 끝나는 임시 스크립트를 작성하십시오.
    2. 실행: mac/.build/macdriver run --app X.app --out <임시> --script s.json -- --demo <임시>/data. 파일은 {"actions":[...]}입니다. 웹: --from plan 실행.
    3. <임시>/events.json에서 failures[].aria를 읽으십시오.
  • 타이핑: 80자를 초과하는 fill 값은 붙여넣기되고, 더 짧은 것은 눈에 보이게 입력됩니다. "test"가 아닌 현실적인 데이터를 사용하십시오. 새 필드를 클릭한 직후 키 입력이 누락되면 (잘린 제목, 빈 필드, 텍스트를 찾을 수 없는 이후 클릭) 분할하십시오: 필드를 click하고, wait 500 후 대상이 없는 fill을 하십시오.
  • 성과: 정확히 하나의 동작에 emphasis: true가 있습니다. 이를 트리거하는 클릭 직후, 클릭 자체가 아닌 캡션이 있는 최종 wait(~2000ms)에 넣으십시오. 카메라는 전체 결과를 보여주기 위해 뒤로 당겨지고, 강조 대기는 실시간으로 재생됩니다. 다른 긴 대기는 빨리 감기됩니다.
  • 런처 비트: 앱이 항상 존재하는 아이콘(데스크톱, 메뉴 막대)이나 글로벌 핫키 뒤에 있으면 plan.launcher를 설정하십시오 (captions, 선택적 hint(예: 핫키), 선택적 badge).
    • 그러면 비디오는 워크스루 전에 비트를 얻습니다: 아이콘이 흐릿한 창들 사이의 평온한 데스크톱에 앉아 있고, 커서가 그것을 클릭하면 실제 창이 그로부터 성장하여 워크스루가 시작되는 정확한 위치에 착지합니다.
    • Remotion에서 합성되며 (녹화기는 앱 창만 캡처) motifImage/motif를 아이콘으로 사용합니다. 코드가 동작을 확인할 때만 사용하십시오.

5. 녹화 + 렌더링

npx tsx src/cli.ts <리포지토리> --plan OUT/plan.json --from plan

로그를 확인하십시오: 동작당 ✓, 실패 시 오류와 함께 ✗. 실패 시 OUT/events.json → failures[]를 읽고 (각각 실패한 순간의 접근성 스냅샷 포함), 대상을 수정한 후 다시 실행하십시오. 실패한 동작은 건너뛰며 치명적이지 않습니다. 성과가 실패한 비디오를 제공하지 마십시오. 초기 동작이 실패하면 이후의 모든 것이 일반적으로 잘못된 화면에서 실행됩니다: 전체 녹화를 불량으로 취급하고 raw.mp4 프레임을 보고 실제로 무슨 일이 일어났는지 확인하십시오.

저렴하게 재실행:

  • 복사, 룩, launcher, 사운드 또는 장면 코드 변경: --from render, 재녹화 불필요.
  • 동작 캡션은 녹화 시간에 events.json에 포함됩니다. plan.json에서 (index로) 거기서 패치하고, npx tsx -e 'import {editRecording} from "./src/edit.ts"; editRecording("OUT")'로 타임라인을 재구축한 다음 --from render를 실행하십시오.
  • 단계 변경: --from plan (재녹화).

6. 보고 전 검토

렌더링된 MP4를 검토하십시오. 스틸 사진만 검토하지 마십시오. 콘택트 시트를 만들고 모든 프레임을 확인하십시오:

ffmpeg -v error -y -i OUT/demo.mp4 -vf "fps=1/2,scale=640:-1,tile=4x8" -frames:v 1 <임시>/sheet.jpg

확인:

  • 스타일 일치: probe.png를 스틸 사진 옆에 놓으십시오. 동일한 배경 계열, 글꼴, 강조색 및 마스코트? 비디오가 다른 브랜드처럼 보이면 다른 것보다 먼저 look을 수정하십시오.
  • 모든 fill 값이 입력된 그대로 화면에 나타납니다. ✓는 동작이 실행되었음을 의미할 뿐 텍스트가 도착했음을 의미하지 않습니다.
  • 카메라는 중요한 것(입력 중인 텍스트, 클릭 중인 컨트롤)에 푸시인되어 있으며, 넓게 또는 빈 캔버스에 있지 않습니다.
  • 캡션은 읽을 수 있고 앱을 절대 가리지 않습니다. 텍스트가 맞습니다. 넘치는 것이 없습니다.
  • 아하 프레임은 성과(로딩 상태나 잘린 버튼이 아님)를 보여줍니다.
  • 비교 비트의 "X → Y"가 믿을 만합니다. 비율이 터무니없으면 기존 방식의 seconds가 부풀려진 것입니다.
  • 오디오가 존재하고 0dB 아래에서 피크: ffmpeg -i OUT/demo.mp4 -af volumedetect -vn -f null -. 동기화를 확인하려면 타이핑 구간의 showwavespic을 그리고 프레임과 비교하십시오.

7. 보고

사용자에게 다음을 제공하십시오:

  • OUT/demo.mp4의 경로와 길이
  • 후크, 기존 방식, 오직 우리 라인 (각각 한 줄)
  • 룩을 어떻게 일치시켰는지 (어떤 색상, 글꼴 및 마스코트가 앱에서 왔는지)
  • 작동시키지 못한 것, 또는 녹화되지 않고 합성된 것 (예: 런처 비트)
  • 앱에서 발견한 버그 (예: 키 입력 누락)

도구가 라이브 조정을 위해 출력하는 npx remotion studio … 명령어와 --music <file> 사운드트랙 옵션을 언급하십시오.

음향 효과

기본 켜짐; --no-sfx는 끕니다. scripts/make-sfx.py는 모든 것을 합성하고 (샘플 없음, 라이선스 없음) assets/sfx/에 저장하며, remotion/Sfx.tsx는 녹화된 이벤트에서 각 사운드의 타이밍을 맞춥니다:

  • 타이핑: 문자당 하나의 촉각 기계식 스위치 사운드 (범프 클릭, 바닥-아웃, 놓기), 녹화기의 실제 타이핑 속도로. 공백은 더 깊은 안정화된 소리, Enter는 더 무거운 소리를 가집니다.
  • 클릭: 녹화된 커서가 클릭한 곳마다 마우스 클릭 (런처 클릭 포함).
  • 전환: 각 장면 변경 시 휘파람.
  • 기존 방식: 단계당 카드 착지 소리 (소프트에서 팝, 볼드에서 둔탁) 및 평결 소리 (소프트 팝, 볼드에서 도장).
  • 성과: 차임.
  • 비교: 행당 팝, 시간 결과에 차임 (소프트) 또는 도장 (볼드).

--music와 함께 음악은 효과 아래에서 낮춰집니다. Sfx.tsx에서 볼륨을 변경하고 --from render를 다시 실행하십시오. 편집 후 스크립트를 다시 실행하여 WAV를 재생성하십시오.

네이티브 Mac 앱

동일한 흐름, 다른 녹화기 (mac/macdriver.swift: Accessibility API로 컨트롤 찾기, 실제 마우스/키보드 이벤트, ScreenCaptureKit은 앱 창만 녹화). --app을 추가하고 -- 뒤에 시작 인수를 전달하십시오:

npx tsx src/cli.ts <리포지토리 또는 ./로컬/디렉토리> --app 경로/대상.app [--app-seed demo/items.json] --prepare -- --demo {data}
  • {data}는 실행마다 새로운 임시 폴더가 되고 --app-seed가 그 안에 복사됩니다. 사용자의 실제 데이터에 대해 절대 녹화하지 마십시오. 앱에 데모/데이터 디렉토리 시작 플래그가 없으면 녹화 전에 추가하거나 (사용자에게 요청) 하십시오. 먼저 사용자의 커밋되지 않은 변경 사항이 있으면 앱을 다시 빌드하십시오.
  • 먼저 mac/.build/macdriver check --open을 실행하십시오. 터미널을 호스팅하는 앱에 대해 접근성 및 화면 및 시스템 오디오 녹화 권한이 필요합니다. 둘 중 하나라도 없으면 정확한 시스템 설정 창을 열고 활성화할 앱의 이름을 알려줍니다 (종료 코드 3). 사용자는 권한을 부여한 후 해당 앱을 다시 시작해야 하며, 이 세션이 종료되므로 재시도하지 말고 나중에 다시 오라고 알리십시오. 화면 녹화가 없으면 --prepare는 여전히 작동하지만 녹화는 작동하지 않습니다. 그동안 스토리보드를 작성하여 준비하십시오.
  • 녹화는 사용자의 실제 마우스와 키보드를 제어합니다 (2060초, 3초 카운트다운). 모든 실행 전에 사용자에게 알리십시오 (짧은 프로브 실행 포함). 사용자가 입력 중일 때 시작하지 마십시오. 사용자의 입력이 포커스를 빼앗고 테이크를 망칩니다.
  • 대상: id, 그다음 placeholder, 그다음 role+name. goto 없음. 대상이 없는 fill은 포커스된 필드에 입력합니다. Enter/Tab/Meta+N에 press를 사용하십시오.
  • 레이블이 없는 아이콘 버튼은 자동화에 보이지 않습니다. 주요 컨트롤에 이름이 없고 코드를 소유하고 있다면 .accessibilityLabel/.accessibilityIdentifier를 추가하십시오.
  • 키가 입력되는 동안 Accessibility 트리를 쿼리하지 마십시오. SwiftUI 앱에서 AX 쿼리는 텍스트 필드를 오래된 텍스트로 재설정하는 리렌더링을 트리거하여 키 입력을 떨어뜨릴 수 있습니다. 드라이버는 타이핑 후에만 포커스된 요소를 읽습니다. 드라이버를 변경하는 경우 그 상태를 유지하십시오. 키 입력이 여전히 사라지면 앱에 이 버그(NSViewRepresentable 텍스트 뷰의 updateNSView가 오래된 바인딩으로 문자열을 덮어쓰는)가 있을 가능성이 높습니다. 사용자에게 알리십시오.

제한 사항

로그인 뒤의 웹 페이지는 공개 페이지 또는 사전 인증된 URL에서 흐름을 시작해야 합니다. 네이티브 녹화는 macOS 전용이며 단일 앱 창을 녹화합니다. 그 외부의 모든 것 (데스크톱, 메뉴 막대, 다른 앱)은 Remotion에서 합성되며 녹화되지 않으므로 보고서에 명시하십시오.

관련 스킬