Communitygithub.com

josueh04/product-video-skills

사용자에게 제품에 대해 인터뷰한 후, `products/<slug>/` 폴더(자체 git 히스토리 포함)를 생성하고, `product.yaml`과 연결된 스킬을 채우고, 소스를 가져와 키트를 빌드합니다. 사용자가 `/product-new`를 입력했을 때만 실행됩니다.

product-video-skills란 무엇인가요?

이 스킬은 AI 에이전트에게 새로운 제품 프로젝트를 시작하는 구조화된 워크플로우를 제공합니다. 사용자와의 짧은 인터뷰를 시작으로 제품명, 포지셔닝, 소스 코드 저장소, 브랜드 정보, 가상의 캐스트, 금지 용어 등 핵심 정보를 수집합니다. 인터뷰를 먼저 진행함으로써 이후 발생할 수 있는 반복적인 수정 작업을 최소화합니다. 스킬은 수집된 답변을 기반으로 제품 폴더를 생성하고(`products/<slug>/`), 이 폴더는 독립적인 git 히스토리를 가지며 덮어쓰기되지 않도록 보호됩니다. 이후 `source-recon` 스킬을 호출하여 모든 소스 코드를 가져오고, `product-kit` 스킬을 호출하여 디자인 토큰, 폰트, 아이콘, 로고와 같은 시각적 요소를 추출합니다. 이 스킬은 Claude Code 환경에서 사용하도록 설계되었으며, 모든 작업은 제품 폴더 내에서만 이루어지고 외부는 수정하지 않습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/josueh04/product-video-skills/tree/HEAD/skills/product-new

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

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

문서

/product-new

워크벤치에 하나의 제품 폴더를 생성합니다: 짧은 인터뷰, 폴더를 작성하는 하나의 스크립트, 그리고 폴더를 채우는 두 개의 모델 호출 스킬(source-recon은 코드를 가져오고, product-kit은 토큰, 폰트, 아이콘, 로고, 캐스트 및 이름을 추출합니다).

무엇보다 먼저 인터뷰를 진행하는 이유: 이 스킬이 비롯된 실제 제작 과정에서 캐스트, 제품명 및 포지셔닝은 검토 때마다 하나씩 결정되었고, 각 결정은 리렌더링을 강제했습니다. 여기서 수집된 모든 답변은 나중에 발생하지 않는 하나의 검토 단계입니다.

시작하기 전에

이 스킬의 실제 경로에서 워크벤치를 확인합니다 (워크벤치 및 제품 폴더에서 작동합니다):

PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"

인수에서 슬러그를 확인합니다: 2~40자의 소문자, 숫자 또는 대시로 구성되며 문자로 시작해야 합니다. $PVS_HOME/products/<slug>가 이미 존재하면 중단하고 그 사실을 알립니다: 제품은 자체 히스토리와 서명된 브리프가 있을 수 있으므로 절대 덮어쓰지 마십시오. 사용자가 --from examples/acme (또는 다른 폴더)를 전달한 경우, 인터뷰는 해당 폴더와 다른 부분만 필요합니다.

저장소를 연결하기 전에 사용자에게 한 번 알립니다: Claude는 제품의 코드를 읽습니다. 즉, 코드가 모델에 컨텍스트로 전송된다는 의미입니다. 사용자는 회사에서 이를 허용하는지 확인해야 합니다.

1. 인터뷰

작은 그룹으로 질문합니다 (메시지당 두세 개의 질문). 사용자의 언어로 질문하세요. 추론할 수 있는 항목에 대해서는 기본값을 제안하여 사용자가 대부분 확인만 하도록 합니다. 전체 질문 목록과 각 질문의 이유는 references/interview.md에 있습니다. 질문하기 전에 읽어보세요.

  1. 제품: 이름, 한 문장으로 설명(포지셔닝), 대상 사용자.
  2. 절대 사용하지 않을 표현: 팀에서 거부하는 설명 (회사 문서에 사용되더라도).
  3. 소스: 각 소스(프론트엔드, 백엔드, 디자인, 문서)에 대해 git URL 또는 로컬 경로, 프로덕션에 있는 브랜치, 앱 디렉토리 및 프레임워크(angular-primeng, react, vue, svelte, html, other). 실제로 배포된 브랜치가 무엇인지 물어보세요: 오래된 체크아웃은 원래 프로덕션에서 실제 시간을 소모했습니다.
  4. 문서: URL, 저장소 경로 또는 mcp:<name> (읽기 전용).
  5. 브랜드: 프론트엔드에 없는 경우에만 (로고 및 폰트 파일). 그렇지 않으면 product-kit이 찾습니다.
  6. 가상 캐스트: 회사와 두세 명의 인물(전체 이름, 555 전화번호, example/.test 도메인의 이메일)을 제안합니다. 기본값으로 제안을 포함한 폐쇄형 질문으로 거부권을 행사할 기회를 제공합니다. 검토자는 평범하거나 실제처럼 들리는 이름에 강하게 반응하며, 비디오 간에 성이 변경되는 인물은 출시되는 버그입니다.
  7. 이름 및 발음: 공식 이름, 라이브 UI에 여전히 표시될 수 있는 레거시 문자열, 브랜드 단어의 발음.
  8. 금지 용어: 경쟁사, 공급업체, 실제 고객 등 절대 보이거나 들려서는 안 되는 모든 것.
  9. 검토자: 각 비디오의 적용 범위 매트릭스 및 클레임 시트에 서명하는 사람.

절대 토큰, 비밀번호 또는 SSH 키를 요청하지 말고, 저장을 제안하지도 마십시오. 소스는 머신이 이미 가지고 있는 git 액세스 권한으로 가져옵니다. URL에 자격 증명이 포함된 경우(https://user:token@...), 사용자에게 제거하도록 요청하십시오. 스크립트는 어쨌든 거부합니다.

2. 폴더 작성

답변을 product.yaml 형태의 임시 파일(모든 하위 집합, references/answers.example.json 참조)로 저장소 외부에 기록한 후 다음을 실행합니다:

"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/product-new/scripts/new_product.py" <slug> \
  --answers <scratch>/answers.json [--from examples/acme]

스크립트는 _template/product를 복사한 다음 --from 폴더를 그 위에 복사합니다(파일이 누락된 예제(예: kit/RULES.md)는 여전히 템플릿의 파일을 가져옵니다). 답변을 product.yaml에 한 줄씩 병합하고(템플릿의 주석은 사용자 문서이므로 유지됨), 템플릿에 없는 경우 CLAUDE.md 및 .gitignore를 작성하고, scripts/link-skills.sh를 실행하여 cd products/<slug> && claude가 동일한 스킬을 보게 한 후 첫 번째 git 커밋을 만듭니다. 기존 슬러그, URL 내 자격 증명, 그리고 명백히 가상이 아닌 캐스트 이메일 또는 전화번호는 거부합니다. 실패하면 오류가 발생한 답변을 수정하고 다시 실행하십시오. 폴더를 수동으로 생성하지 마십시오.

"여전히 채워야 할 product.yaml"이 출력되면 인터뷰에서 다루지 않은 템플릿 플레이스홀더입니다. 이에 대해 질문하거나 사용자에게 남은 항목을 알려주십시오.

3. 채우기

Skill 도구를 통해 다음 모델 호출 스킬을 이 순서대로 호출합니다:

  1. source-recon: 모든 소스를 products/<slug>/sources/로 가져오고 sources.lock에 고정합니다. 액세스 문제로 가져오기가 실패하면 정확한 git 오류를 보고하고 중단합니다: 사용자는 자격 증명을 제공하는 것이 아니라 자신의 머신에서 액세스 권한을 수정합니다.
  2. product-kit: kit/tokens.css, 폰트, 아이콘, 로고를 추출하고 캐스트, 이름 및 발음을 키트와 kit/RULES.md에 기록합니다.

두 스킬 모두 제품 폴더 내에서만 씁니다. sources/ 안의 어떤 것도 절대 편집하지 마십시오.

4. 보고

하나의 짧은 테이블과 함께 다음 명령어를 표시합니다:

항목값
폴더products/<slug>/ (git: 첫 번째 커밋 또는 그렇지 않은 이유)
소스역할, 브랜치, sources.lock의 커밋
키트product-kit이 추출한 것과 찾을 수 없었던 것
캐스트최종 거부권 행사를 위한 확정된 이름
미해결product.yaml에 남아 있는 플레이스홀더, 확인되지 않은 모든 것

다음: cd products/<slug> && claude, 그 다음 /video-new <video>.

Individual skills in this repo

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

josueh04/product-video-skills

Extract, once per product, everything every video of it reuses and write it to kit/ and product.yaml (design tokens, font subsets as woff2, icon subsets as SVG from the product's own icon packages, logos in light, dark and app-tile variants from the repo, a fictional cast proposed once for veto and then frozen, the canonical-names map, pronunciations, banned terms and the read-only tool list). Use it when a product is set up or its kit is missing or incomplete, when a video needs an icon, font or logo that is not in kit/ yet, when someone asks for demo names, fake customers, phone numbers or emails, when a brand word is mispronounced or an old product name shows up, and when checking that demo data is fictional.

josueh04/product-video-skills

Back every sentence of a video's narration (audio/lines.tsv) and every screen it shows with a citation into the pinned source code (role/path:line@sha) or a docs URL, mark what is visible in the UI versus backend-only, flag restricted or unreleased features, and cut or rewrite anything unbacked; writes the video's TRUTH.md and checks it with truth_check.py. Use it whenever a script or narration is drafted or edited, before voice is generated, before a build, when someone asks "can we say this?", "is this true?", "does the product really do X?", when a reviewer asks for a feature or a claim the product may not support, and when a source document (pitch deck, PRD, marketing page) makes claims the video wants to repeat.

josueh04/product-video-skills

Check a rendered product video before anyone else sees it: worker-pattern flicker, black frames, loudness and true peak, clipping, clicks at clip edges, overlapping narration, speech to text against the script, banned terms and legacy names, camera zoom, contact sheets, frame strips at transitions and parity against the approved version; then write qa/REPORT.json, the only thing deliver.py accepts. Use it after every HyperFrames render, whenever someone asks "is the render clean", "QA this", "check the video", "check the audio", "why does it flicker", "there is a click", "compare v3 with v2", "did the approved part change", or before showing, sending, uploading or delivering any MP4, even when the request does not say QA. Also use it to triage a defect a reviewer reported in a render.

josueh04/product-video-skills

Write a product video's narration and turn it into voice clips with word timings, pronunciation fixes, sound effects and even loudness. The script becomes a table of moments and then audio/lines.tsv (one clip per sentence, with role and speed columns); tts.py voices it with ElevenLabs or the free macOS say voice, maps brand respellings back to the on-screen spelling, normalizes every clip and writes audio/timings.json for the composer; make_sfx.py builds typing tracks from real keystrokes and places recorded click and pop sounds. Use it whenever a video needs a script, narration, voice-over, lines.tsv, timings.json, TTS, a new take, a voice or casting choice, a pronunciation fix ("it says the name wrong"), a changed sentence, a tone note ("too hype", "sounds cut off"), audio levels, a click at the end of a clip, typing or click sounds, or when the build stage asks for the voice. Also use it for silent loops, which still need a moment table and SFX.

josueh04/product-video-skills

The animation rules that keep HyperFrames' parallel render workers from dropping, flashing or flickering elements, plus a static lint (lint_motion.py) that finds the violations in a video's template before it costs a render. Use it whenever you write or edit GSAP tweens, timelines, cursors, camera moves, typing, scrolls or pop-ups in a HyperFrames composition or a video's src/template.tpl, whenever a render shows flicker, stutter, an element that vanishes on some frames, a title that flashes, or a "WORKER PATTERN" line from scan_render.py or qa.py, and whenever the preview looks right but the MP4 does not. Also use it to review someone else's timeline code before rendering.

josueh04/product-video-skills

Pin a product's source code (read-only exports in sources/ plus sources.lock), confirm that the pinned commit is what runs in production, and map every screen of a video brief to its route, components, i18n strings and state, written to the video's SOURCES.md. Use it whenever a video needs to know where a screen lives in the code, when sources/ is missing or stale, before ui-spec-from-code or product-truth start on a video, after the product's frontend changed ("what changed", "which videos are affected", "refresh the sources", "is this checkout current", "which commit is in prod"), and when there is no code and you need an inventory of the no-code references (recordings, recovered captures, docs) a screen can be rebuilt from.

josueh04/product-video-skills

Compose a narrated product demo in HyperFrames: the stage (the product UI rebuilt at its real viewport and scaled to 1080p, camera, rack focus with veil, chapter titles, cursor and clicks, typing, streaming text, pop-ups, toasts, scrolls, end screen and lockup) and the build.py that anchors every beat to a word of the narration. Use it whenever you write or edit a video's video/build.py, src/template.tpl or src/app.css, place a beat on a word, add a chapter, a click, a pop-up or a push-in, frame a screen, build the end screen or lockup, snapshot setup beats, or render a draft or delivery MP4 of a product video in this workbench. Also use it when someone says "the cursor is off", "too zoomed in", "too fast", "it feels chaotic", "the title flashes", "sync the UI to the voice", or asks for a walkthrough, demo or pitch video of a UI.

josueh04/product-video-skills

Gather pixel references for UI that the code cannot show, or to check a rebuild against the real thing, using frames and timed OCR text from screen recordings, captures recovered from past Claude Code session transcripts, a local instance of the app built like production, and web research for third-party apps, plus side-by-side parity images and contact sheets. Use it whenever someone hands over a screen recording (.mov or .mp4) of the product, when a screen has no usable source code (a stale checkout, another company's UI such as a sign-in page, calendar or CRM, runtime output from a backend not in the repos), when asked "what does it really look like", "match the recording", "how long does that animation take in the app", "compare our render to the real app", or when screenshots from an earlier session might already exist. Never uses the reviewer's personal browser.

josueh04/product-video-skills

Turn a product's real frontend code into 1:1 rebuild specs for a video, one read-only subagent per screen, each returning static HTML, CSS with every variable resolved to its literal value and cited (role/path:line@sha), every state, transitions with exact durations and easings, icons from the code's own icon sets, and the exact i18n strings; plus resolve_tokens.py to write the product's design tokens to kit/tokens.css. Use it whenever a screen of the product has to appear in a video, when writing or fixing video/src/app.css or the template markup, when someone asks for exact sizes, colors, fonts, paddings, animations or icons of a screen, when a rebuilt screen "looks off" next to the real app, and when the design tokens or theme of a product need extracting. Framework adapters cover Angular with PrimeNG (proven), React, Vue, Tailwind and plain HTML (unproven).

josueh04/product-video-skills

Say where this session stands in the Product Video Skills workbench (setup state, which product and video the current folder belongs to, the stage of every video) and the exact next command to type. Also answers "how do I..." questions about the workbench from its docs.

josueh04/product-video-skills

Coordinate the build of one or more signed videos of the current product with subagents (source recon, product truth, UI specs, voice, one builder per video), re-run QA itself, then deliver. A light coordinator that never builds itself. Run only when the user types /video-build.

josueh04/product-video-skills

Start a new video of the current product - create videos/<video>/, write BRIEF.md, the feature coverage matrix (COVERAGE.md) and the claims sheet (CLAIMS.md), propose chapters, then stop for the reviewer's sign-off. Never builds. Run only when the user types /video-new.

josueh04/product-video-skills

Turn a batch of reviewer feedback on the product's videos into one table per video, fix every video that got notes in parallel (one subagent each) while keeping approved parts, re-run QA and parity, bump versions and deliver. Run only when the user types /video-review.

josueh04/product-video-skills

Check this machine and install the pinned video toolchain of the Product Video Skills workbench (HyperFrames CLI, its rendering Chrome and its agent skills from the same release, the Python environment, the speech model for QA), then run the self-check. Safe to run again. `/video-setup check` only reports.

관련 스킬