Communitygithub.com

Playgama/gamedev-skills

게임 개발자가 웹 게임에 대한 프로모션, 트레일러, 개발 일지, '제작 방법' 영상을 Playgama AI 로고 인트로로 시작하여 게임 자체의 비주얼 스타일로 제작할 수 있게 해줍니다. 실제 게임플레이, 프롬프트, 에이전트 단계를 화면 카드로 보여주고, 게임의 색상, 폰트, UI를 그대로 사용합니다.

gamedev-skills란 무엇인가요?

Playgama/gamedev-skills는 게임 개발자가 AI 에이전트(Claude Code, Cursor 등)를 사용하여 만든 웹 게임에 대한 다양한 영상(트레일러, Shorts, TikTok, Reels, 랜딩 페이지용 비디오, Playgama 리스팅용 영상)을 제작할 수 있도록 설계된 AI 스킬입니다. 이 스킬은 Playgama AI 로고 인트로(3초)와 함께 게임 자체의 색상, 폰트, 패널, UI, 음악을 그대로 사용하여 마치 게임이 직접 연출한 듯한 영상을 만듭니다. 주요 기능으로는 프레임 단위 게임플레이 녹화, 음성 해설(TTS 또는 자체 녹음), 배경 음악, 엔드 카드, 썸네일 생성 등이 포함되어 있습니다. 또한 실제 프롬프트, 에이전트 단계, 타임스탬프 등 진짜 제작 과정을 화면 카드로 표시하여 신뢰성을 높입니다. macOS, Linux, Windows에서 동일하게 작동하며, Node.js, ffmpeg, HyperFrames 등을 필요로 합니다. 이 스킬은 개발자가 "트레일러 만들어줘", "내 게임 숏츠 영상", "이 게임 만든 방법 영상" 등 비디오 관련 요청을 할 때 자동으로 활성화되며, Playgama MCP나 Playgama Bridge SDK를 통해 게시된 게임에 특히 적합합니다.

지원 대상~Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/Playgama/gamedev-skills/tree/HEAD/skills/playgama-game-video

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

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

문서

게임에 대한 영상 만들기

Playgama를 위한 게임 영상을 만드는 방법입니다. 영상은 Playgama가 아닌 게임 자체의 모습을 닮습니다: 게임의 색상, 폰트, 패널 및 사운드를 그대로 사용합니다. Playgama는 로고(시작 부분 3초 인트로와 모서리의 작은 버그)와 링크만 추가합니다. 나머지 작업은 세 가지에 집중됩니다: 스토리는 사실적이고 구체적이며, 게임플레이는 깔끔하게 촬영되고, 첫 1초가 다음 1초를 잡아당깁니다.

번들 파일:

파일설명
assets/playgama-ai-logo.svg, .png공식 Playgama AI 로고(591×133): 보라색 알약 모양에 playgama 워드마크, 그 옆에 회색 상자에 "AI"가 오려진 형태입니다. PNG는 4배 투명도입니다.
assets/template/HyperFrames 스타터 비디오(1920x1080): 인트로, 세 개의 게임플레이 슬롯, 제목, 엔드 카드, 음악 및 음성 트랙이 포함됩니다. 상단의 하나의 테마 블록에 게임의 비주얼 스타일이 저장됩니다.
assets/sting-preview.mp4인트로 애니메이션이 어떻게 보여야 하는지 보여주는 미리보기, 게임 영상이 시작되는 자리 표시자로 전환됩니다.
assets/sting.html순수 CSS(7KB, 라이브러리 없음)로 작성된 인트로 애니메이션 단독입니다. 어떤 페이지나 비디오 도구에든 넣을 수 있습니다.
assets/playgama-ai-sting.html재생, 속도, 스크러빙 컨트롤이 있는 리뷰 페이지로 구현된 동일한 애니메이션입니다. 브라우저에서 열고 게임 스크린샷을 올리면 로고가 게임 위에 표시되는 것을 확인하거나 디자이너에게 전달할 수 있습니다.
scripts/film.mjs, scripts/vclock.js모든 웹 게임을 프레임 단위로 촬영하여 어떤 크기로든 부드러운 MP4로 만듭니다.
scripts/doctor.mjs, scripts/new-video.mjs시스템을 확인하고 설치할 항목을 알려줍니다. 비디오 폴더(템플릿, gsap, puppeteer)를 생성합니다.
scripts/palette.mjs게임의 스크린샷에서 샘플링한 게임 색상입니다. 코드에 테마가 없을 때 사용합니다.
scripts/voice.mjs음성 해설: ElevenLabs, OpenAI, Gemini, Cartesia(또는 무료 드래프트 음성)에서 가져오고, 귀로 선택할 수 있는 페이지를 제공하며, 음악이 음성 아래로 낮아진 음성 트랙을 생성합니다.
references/story-and-script.md형식, 실제 예시 대사가 포함된 비트 시트, 화면 자료에 대한 규칙.
references/game-look.md게임의 비주얼 스타일 가져오기: 색상, 폰트, 패널, 모션, 사운드를 찾을 위치, 템플릿의 테마.
references/filming.md촬영 방법: 준비, 설정 및 프레임별 스크립트, 순간 선택, 첫 프레임.
references/voice-and-music.md음성 해설(텍스트 음성 변환 또는 직접 녹음), "Playgama" 발음, 테이크 확인, 음악 레벨.
references/edit-and-render.mdHyperFrames에서 조합: 템플릿, 카드, 세로 컷, 체크, 렌더링, 리뷰.

필요한 것

macOS, Linux, Windows에서 동일하게 작동합니다.

  1. node scripts/doctor.mjs로 시스템을 확인하고 설치할 항목을 알려줍니다.
  2. node scripts/new-video.mjs <folder>로 비디오 폴더를 생성합니다: 템플릿, gsap.min.js, 그리고 촬영을 위한 puppeteer가 포함됩니다. 이후 모든 명령은 해당 폴더에서 실행하세요.
  • 촬영: Node 22+ (HyperFrames에서 필요), PATH에 ffmpeg와 ffprobe, 그리고 puppeteer가 필요합니다. film.mjs는 실행 디렉토리 또는 스크립트 옆에서 이를 찾습니다. 게임은 URL(개발 서버 또는 빌드 위의 정적 서버)에서 실행 가능해야 합니다.
  • 조합 및 렌더링: HyperFrames (npx [email protected]; 첫 실행 시 약 370MB의 패키지와 헤드리스 브라우저를 다운로드합니다).
  • 자체 음성이 아닌 경우: ElevenLabs 또는 scripts/voice.mjs가 작동하는 다른 서비스의 키가 필요합니다. 한 번 설정(references/voice-and-music.md)하고, Whisper 또는 다른 음성-텍스트 변환 도구로 테이크를 확인하세요.
  • 음악: 사용 허가를 받은 악기 트랙.

워크플로우

이 순서대로 작업하세요. 각 단계는 다음 단계를 준비하며, 두 번의 승인 포인트가 시간을 절약해 줍니다.

  1. 영상에 동의합니다. 다른 작업을 시작하기 전에 형식, 길이 및 목표를 결정합니다(아래 표 참조). 영상의 용도를 물어보세요: 플레이어용인지, 스토어 페이지용인지, 다른 개발자용인지, Playgama 챌린지나 카탈로그용인지.
  2. 실제 스토리를 수집합니다. 실제 프롬프트, 타임스탬프, 커밋, 버그, 숫자 및 스크린샷을 수집합니다(references/story-and-script.md). 게임이 AI 에이전트로 빌드된 경우, 채팅 기록이 가장 풍부한 소스입니다: 읽어보고 시간과 정확한 인용을 기록하세요.
  3. 게임의 비주얼 스타일을 가져옵니다 (references/game-look.md): 자체 파일에서 색상, 폰트, 패널, 로고, 음악 및 UI 사운드를 가져옵니다. 이를 템플릿의 테마 블록에 작성하세요.
  4. 스크립트를 작성한 후 승인을 위해 멈춥니다. 음성 대사와 화면에 표시될 내용을 각 행에 하나씩 작성합니다. 개발자가 음성 제작 전에 문구와 비주얼 스타일을 승인합니다: 녹음된 음성을 다시 녹음하려면 다시 녹음해야 합니다.
  5. 게임플레이를 촬영하고 스크린샷을 찍습니다. scripts/film.mjs를 사용하여 전달 크기로 촬영합니다(아래 "게임의 사진" 및 references/filming.md 참조). 스크립트의 각 비트당 하나의 테이크를 계획하고, 각각 몇 초씩, 게임 자체의 컨트롤이나 디버그 훅으로 준비합니다.
  6. 스틸 이미지를 만듭니다. 게임의 비주얼 스타일로 제작합니다. 실제 코드(실제 줄 번호 포함), 실제 프롬프트와 에이전트 단계, 웹 페이지 및 표지를 사용합니다.
  7. 음성을 녹음하고 음악을 선택합니다 (references/voice-and-music.md, scripts/voice.mjs). 인간이 음성 테이크를 듣습니다. 텍스트-음성 변환은 어떤 대본도 포착할 수 없는 방식으로 실패하기 때문입니다.
  8. 조합하고 렌더링합니다. 템플릿을 사용하여(references/edit-and-render.md). 체크를 실행하고, 렌더링한 후 몇 초마다 프레임을 추출하여 완료라고 부르기 전에 모든 프레임을 확인합니다.
  9. 패키징합니다: 썸네일(1280x720, 게임의 최고의 프레임, 게임 자체 폰트로 최대 4개의 큰 단어), 제목 및 게임 링크가 포함된 설명.

형식을 먼저 선택하세요

비디오형태길이시작 방식
Short / Reels / TikTok9:16, 1080x192015–35 초첫 프레임에 게임플레이; 로고는 작은 모서리 버그로만 표시
트레일러 / 프로모16:9, 1920x108030–90 초인트로(3초), 그 다음 최고의 게임플레이
"제작 방법" 스토리16:93–6 분훅 라인이 있는 게임플레이, 그 다음 인트로 또는 제목
튜토리얼 ("Playgama MCP로 게시")16:9각 파트당 1–3 분인트로, 그 다음 결과를 먼저, 그다음 단계

Short는 첫 1초에 결정됩니다. 시청자가 머물거나 스와이프합니다. 한눈에 읽히는 전체 화면 게임플레이로 시작하는 Short는 긴 코멘트 카드, 게임 메뉴, 채팅 상자 등 읽을 거리로 시작하는 것보다 훨씬 더 많은 시청자를 유지합니다. 따라서 Short는 인트로나 텍스트로 절대 시작하지 않습니다.

게임의 비주얼 스타일

영상은 게임처럼 보입니다: 게임을 해본 사람이라면 어떤 프레임에서든 알아볼 수 있어야 합니다. 비주얼 스타일은 Playgama가 아닌 게임 자체에서 가져옵니다(references/game-look.md):

  • 색상: UI와 코드에서 가져옵니다: 배경, 패널, 텍스트, 버튼 및 강조 색상입니다. 코드에 테마가 없으면 scripts/palette.mjs로 메뉴와 HUD를 샘플링합니다.
  • 폰트: 모든 폰트는 게임과 일치해야 하며, 코드 폰트도 포함됩니다.
    • 제목은 게임의 제목 또는 로고 폰트, 레이블과 프롬프트는 UI 또는 텍스트 폰트를 사용합니다.
    • 코드와 도구 호출은 게임의 정신에 맞는 고정폭 폰트를 사용합니다: 픽셀 아트에는 픽셀 폰트, 어둡거나 레트로 게임에는 타자기 폰트.
    • 템플릿의 DM Mono는 자리 표시자일 뿐입니다.
  • 패널 및 버튼: 게임 패널 모양의 카드, 엔드 카드의 버튼은 게임의 메인 버튼과 같은 모양, 자체 아이콘 및 로고.
  • 모션 및 사운드: 게임의 UI처럼 움직입니다(바운시, 차분함, 또는 픽셀 단계). 게임 자체의 음악과 UI 사운드를 우선 사용합니다.
  • 검은 슬라이드가 아닌 사진 위의 카드. 어두워진 게임 프레임 위에 프롬프트나 단계를 배치하고, 게임플레이 아래쪽을 게임의 배경색으로 어둡게 한 후 제목을 낮게 배치합니다. 이름만 있는 카드보다는 실제 사진을 나란히 배치하는 것이 좋습니다.

색상, 폰트 및 패널 모양은 템플릿의 스타일 최상단에 있는 하나의 테마 블록에 들어갑니다.

게임의 사진

키트에는 게임 푸티지가 포함되어 있지 않습니다. 게임의 모든 사진은 개발자 본인의 게임에서 scripts/film.mjs(references/filming.md)로 직접 촬영합니다. 이는 비디오, 썸네일, 카드 뒤의 프레임 및 리뷰 페이지를 포함합니다.

  • 클립: 각 비트당 하나의 테이크, 예: node scripts/film.mjs --url http://localhost:5173 --out clips/gameplay-1.mp4 --seconds 6.
  • 스크린샷: 동일한 명령에 --still <seconds>를 추가하면 해당 시점의 PNG 하나가 저장됩니다. 단계에서 게임 사진이 필요할 때마다 하나씩 찍습니다:
    • 메뉴와 HUD, 비주얼 스타일 읽기용 (scripts/palette.mjs);
    • 프롬프트 카드나 제목 뒤의 프레임;
    • 썸네일 및 엔드 카드;
    • 게임 위의 인트로, 모서리 버그가 HUD와 겹치지 않는지 확인. 스크린샷을 assets/playgama-ai-sting.html에 드롭하거나 첫 번째 클립을 템플릿에 넣고 npx [email protected] snapshot . --at 3.5 --describe false 실행.
  • 세로 컷은 1080x1920으로 촬영하며, 게임의 카메라를 이에 맞게 재구성합니다.
  • 게임을 여기서 실행할 수 없는 경우(네이티브 빌드, 로그인 장벽, 온라인 전용 게임), 개발자에게 전달 크기의 화면 녹화 및 스크린샷을 요청하세요. 화면에 커서나 알림이 없어야 합니다. 다른 게임, 스토어 페이지 또는 이 키트의 예제 사진으로 빈 공간을 채우지 마세요.

Playgama가 추가하는 것

로고와 링크만 추가합니다. Playgama의 보라색과 어두운 판은 로고와 인트로에 속하며, 비디오 자체에는 속하지 않습니다.

  • 로고: assets/playgama-ai-logo.svg 공식 파일입니다: 보라색 #9747ff 알약 모양에 흰색 워드마크, 그리고 회색 #d2d2d2 상자에 "AI"가 오려져 있습니다.
    • 그대로 사용하세요: 색상 변경, 늘리기, 효과 추가, 간격 변경 또는 다시 그리지 마세요.
    • "AI"는 구멍이므로 로고 뒤의 내용이 보입니다.
    • 알약 높이의 최소 절반 이상의 여유 공간을 확보하세요.
    • 모서리 버그로 사용할 때 1920 프레임에서 약 200px 너비입니다. 게임의 HUD가 해당 모서리에 있으면 HUD를 가리지 않도록 다른 모서리로 이동하세요(references/edit-and-render.md).
  • 링크: Playgama로 연결되는 링크는 게임 자체 페이지로 연결됩니다: 엔드 카드와 설명에 포함됩니다.

인트로 스팅

Playgama의 아이덴트, 예를 들어 트레일러 전에 퍼블리셔 로고가 나오는 것과 같습니다: 약 3초, assets/template/index.html에 미리 제작되어 있습니다. 모든 비디오에서 자체 색상과 타이밍을 유지하며, 그 이후는 게임의 것입니다. assets/sting-preview.mp4가 자리 표시자로 전환되는 모습을 보여줍니다. 개발자 게임 위에서 보려면 게임의 스크린샷 또는 클립을 찍으세요("게임의 사진" 참조).

  • 구성: 부드러운 보라색 글로우가 있는 어두운 배경에서 보라색 알약이 중심에서 자랍니다(0.05초, 0.55초 동안). 흰색 playgama 워드마크가 왼쪽에서 오른쪽으로 나타납니다(0.42초). 회색 상자가 알약 옆에 튀어나오고(0.92초), "A"와 "I"가 그 안에서 잘립니다(1.12초, 1.27초). 알약 위로 빛의 띠가 지나갑니다(1.55초).
  • 전환: 로고 전체가 19% 크기로 오른쪽 상단 모서리로 날아가며, 1920×1080 프레임의 상단과 오른쪽에서 39px 떨어집니다(2.75초, 0.62초 동안). 게임플레이가 아래에서 페이드 업되는 동안(3.0초) 버그로 그 자리에 남습니다.
  • 부분은 공식 파일의 자체 모양에서 240px 높이로 그려지므로 인트로가 정확히 로고로 끝납니다.
  • 변경: 타이밍을 유지하세요. 콜드 오프닝(스토리)을 먼저 넣으려면 인트로를 나중에 시작하세요: 템플릿에서 S를 설정합니다(references/edit-and-render.md). 9:16 컷의 경우 빌드를 생략하고 첫 프레임부터 버그를 모서리에 표시합니다.

실수로부터 얻은 규칙

  • 화면에는 실제 자료만 표시합니다.
    • 실제 프롬프트, 실제 숫자, 실제 타임스탬프 및 실제 코드를 표시합니다.
    • 숫자가 예시용이어야 한다면, 화면에 "예시 데이터"라고 표시하는 동안 내내 표시하세요.
    • 인용, 댓글, 플레이어 수 또는 리뷰를 절대 조작하지 마세요. 조작된 숫자를 확인한 시청자는 나머지도 신뢰하지 않습니다.
  • 화면의 프롬프트는 개발자의 말입니다.
    • 비디오 언어로 번역하되, 단어를 바꾸지 마세요.
    • 긴 프롬프트는 요약하지 말고 "[…]"로 자릅니다.
    • 에이전트 단계는 실제 도구 호출을 실제 순서로 표시합니다. 예: create_application → start_archive_upload → get_archive_status (통과) → publish_sandbox (공개 링크).
  • 자신의 아트만 사용합니다. 다른 게임의 캐릭터, 로고 또는 아트를 표시하지 마세요. 게임이 "비슷하더라도" 다른 게임을 언급하지 말고 장르를 말하세요("공포 탈출 게임").
  • Playgama는 "플레이-가-마"로 발음합니다. 영어 음성은 "play-GAY-ma"라고 말하지 않도록 조정합니다(references/voice-and-music.md).
  • 모든 음성 테이크를 텍스트(대본)와 비교하여 확인하고, 사람이 듣습니다. 텍스트-음성 변환은 문장을 반복하거나, 아무도 쓰지 않은 문장을 추가하거나, 자체 지침을 소리 내어 읽거나, 마지막 음절을 삼키는 경우가 있었습니다. 각각 자체적으로는 괜찮게 들렸던 테이크에서 발생했습니다.
  • 첫 번째 게임플레이 프레임은 1초 이내에 읽을 수 있어야 하며, 메뉴나 로딩 화면이 아니어야 합니다.
    • Short는 이 프레임으로 시작합니다. 트레일러나 스토리는 인트로나 콜드 오프닝 직후에 도달합니다.
    • 최고의 순간을 촬영하세요. 레벨의 시작이 아닙니다.
    • 게임플레이의 처음 2초 내 텍스트: 최대 4개의 큰 단어.
  • 푸티지는 기계에 남아 있습니다. HyperFrames의 snapshot은 Gemini 또는 Google 키가 설정되어 있을 때 프레임을 Gemini로 보내 설명을 생성하며, 비디오 폴더의 .env 파일을 읽습니다. 모든 snapshot에 --describe false를 전달하고, voice.mjs의 공유 키 파일에 음성 키를 보관하고 비디오 폴더에는 두지 마세요.

완료되었을 때

개발자는 다음을 받습니다:

  • 마스터 MP4와, 크기가 큰 경우 작은 미리보기;
  • 썸네일;
  • 제목, 설명(게임 링크, 긴 비디오의 챕터, #playgama) 및 고정 댓글 내용이 포함된 텍스트 파일.

각 파일의 위치와 개발자가 결정해야 할 사항(게시 시간, 듣지 못한 음성 테이크, 확인하지 못한 모든 것)을 알려주세요.

관련 스킬