Communitygithub.com

인터랙티브 사이트

사용자의 인터랙티브 비디오를 위한 호스팅 사이트: 페이지, 블록, 테마, 퍼블리싱. 포트폴리오나 링크 페이지로 활용하세요.

인터랙티브 사이트란 무엇인가요?

이 스킬은 `interactive.vidmoat.com` 하위에 사용자 맞춤형 인터랙티브 비디오 사이트를 구축, 편집, 배포하는 방법을 안내합니다. 사이트는 순수하게 사용자의 비디오만을 위한 프레임 역할을 하며, 모든 페이지는 방문자를 한 화면 안에서 플레이어로 안내하도록 설계됩니다. MCP 도구(`get_interactive_site`, `edit_interactive_site`, `publish_interactive_site`) 또는 API를 통해 사이트를 생성하고, 테마(어두운/밝은 톤, 색상 팔레트, 폰트 등)를 설정하며, 히어로 영역, 그리드, 텍스트, 어바웃 등 다양한 섹션으로 페이지를 구성할 수 있습니다. 특히 공개 및 공유된 인터랙티브 비디오만 사이트에 표시되며, 배포 전 미리보기 URL을 제공하고 사용자 요청 시에만 공개 페이지로 전환하는 워크플로를 강조합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vidmoat/skills/tree/HEAD/skills/vidmoat/interactive-sites

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

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

문서

인터랙티브 사이트 구축하기

https://{prefix}.interactive.vidmoat.com 사이트는 사용자 자신의 인터랙티브 비디오를 주변 요소 없이 보여주는 공간입니다. 비디오가 핵심이고, 사이트는 프레임 역할을 합니다. 모든 페이지는 방문자가 한 화면 안에서 플레이어에 도달하도록 해야 합니다.

사용할 도구: get_interactive_site, edit_interactive_site, publish_interactive_site (MCP 및 API). 앱에서는 동일한 호출이 agentWorkspace를 통해 action: "interactive_site" 및 site: {tool, ...arguments}로 전달됩니다.

워크플로

  1. 먼저 읽기. videos: true와 함께 get_interactive_site를 호출합니다. 사이트 존재 여부(canCreate), 페이지 및 각 sectionId, 문제(problems), 개정 번호(rev)를 반환합니다. 요청된 부분만 sectionId로 변경하고 rev를 다시 보냅니다.
  2. 게시되고 공유된 비디오만. 사이트는 계정의 인터랙티브 비디오 중 선택사항이 게시되고 공유된 것만 표시합니다. videos: true는 정확히 해당 비디오들을 ID와 함께 나열합니다. 사용자가 이름을 지정한 비디오가 목록에 없으면 (사용자 동의 하에) 먼저 게시(publish_interactive with share: true)하며, 임의로 추측하거나 다른 비디오로 대체하지 않습니다.
  3. 한 번 이름 짓기. get_interactive_site와 prefix: "name"으로 이름을 확인하고(한두 번 시도로 제한, 아이디어 반복 금지), 그 후 edit_interactive_site에 create: {prefix, title}을 사용합니다. 사용자 본인의 이름이나 브랜드를 사용하며, 계정당 하나의 사이트만 생성됩니다.
  4. 하나의 테마. setTheme: tone (dark, light), palette (warm, neutral, cool, forest, plum), font 및 headingFont (system, serif, mono, rounded), corners (soft, round, square), density (comfortable, compact, airy), width (normal, narrow, wide), playerAccent (video는 각 비디오 고유 스타일 유지, site는 사이트 스타일 사용), accent #RRGGBB. 영화 스타일에 맞춰 선택: 다크 톤은 영화적이거나 야간 영상에, 라이트 톤은 튜토리얼이나 코스에 적합. 특정 항목을 생략하면 기본값을 유지합니다.
  5. 홈 페이지는 다음 순서로: hero (제목, 한 줄 설명, 가장 강력한 비디오를 video로, 버튼), 나머지를 위한 grid, 그 다음 설명 섹션 (분기 영화를 위한 story, text, about), 마지막에 cta 또는 links. 한 개의 추천 비디오만 표시, 세 개 안 됨.
  6. 적은 페이지. 보통 홈 페이지만으로 충분합니다. 한 화면을 넘는 내용이 있을 때만 films 또는 about 페이지를 추가합니다. setNav로 페이지 목록을 설정하고, setHeader로 제목, 태그라인, 로고( images: true로부터)를 제공합니다.
  7. 일괄 편집. 모든 ops를 포함한 한 번의 edit_interactive_site 호출(모두 적용되거나 모두 실패), 그 후 응답의 problems를 확인합니다.
  8. 보여 준 후 게시. 사용자에게 previewUrl을 제공합니다 (실제 주소의 초안, 1시간 유효). 사용자가 요청할 때만 publish_interactive_site로 게시합니다. 공개 페이지입니다. publish: false는 즉시 내립니다.

예시

{"create": {"prefix": "river-films", "title": "River Films"}}
{"rev": 3, "ops": [
  {"op": "setTheme", "tone": "dark", "palette": "cool", "headingFont": "serif", "accent": "#4CC9F0"},
  {"op": "setHeader", "title": "River Films", "tagline": "Short films you play"},
  {"op": "addPage", "slug": "films", "title": "Films"},
  {"op": "setNav", "links": [{"label": "Home", "page": ""}, {"label": "Films", "page": "films"}]},
  {"op": "addSection", "page": "", "section": {"kind": "hero", "heading": "Films where you choose what happens next", "body": "Pick a path, then go back and take the other one.", "video": "<videos:true에서 가져온 id>", "cta": {"label": "See every film", "page": "films"}}},
  {"op": "addSection", "page": "", "section": {"kind": "grid", "heading": "Play them all", "videos": ["<id>", "<id>"], "columns": 3}},
  {"op": "addSection", "page": "", "section": {"kind": "story", "video": "<id>", "heading": "How it branches"}}
]}
{"rev": 4, "ops": [{"op": "updateSection", "sectionId": "<다이제스트에서 가져온 값>", "set": {"heading": "New films every month", "body": null}}]}

주의사항

  • 사용자 정의 코드 없음. HTML, CSS, 스크립트, 임베드 또는 "사용자 정의 스타일링"은 절대 제공하지 마세요. 거부된 값은 허용 목록과 함께 반환되며, 그중에서 선택해야 합니다.
  • 페이지 ""는 홈입니다. 다른 페이지는 슬러그(films, about)를 사용하며, 슬러그 이름을 바꾸면 연결된 링크도 함께 이동합니다.
  • 버튼 (cta)은 {label, page} 또는 {label, href} (https 주소 사용) 형태입니다. links는 https만 가능합니다.
  • text는 제한된 마크다운 사용: ## 및 ###, 목록, 굵게, 기울임, https 링크. HTML, 이미지 사용 불가.
  • about은 images: true에서 가져온 이미지 ID를 사용하며, URL 사용 불가.
  • 액센트 색상이 거부될 수 있음 해당 색상 위의 텍스트나 페이지가 읽기 어려울 경우. 다크에는 밝은 액센트, 라이트에는 어두운 액센트를 시도하세요.
  • 제한 초과 시 잘리지 않고 거부됨: 페이지 6개, 페이지당 섹션 12개, 그리드당 비디오 12개, 내비게이션 링크 6개, 링크 10개; 제목 90자, 본문 600자. 직접 단어를 줄이세요.
  • null은 updateSection에서 선택 필드를 제거하며, 생략하면 유지됩니다.
  • 검색 엔진이 게시된 사이트를 찾을 수 있음 (사이트맵 및 비디오 데이터 포함). 각 페이지의 title과 description을 낯선 사람이 검색할 때를 대비해 작성하세요. setSettings indexing: false는 사이트를 비공개로 유지하고 싶을 때 사용합니다.
  • 스토리 맵은 게임의 재미를 망칩니다. 기본적으로 오프닝과 선택지만 표시되며, 장면과 엔딩 수는 집계됩니다. reveal: "full"은 수업이나 안내서에만 사용하고, 게임이나 미스터리에는 절대 사용하지 마세요. 비밀을 약속하는 문구 옆에도 사용하지 마세요.
  • 포스터가 중요합니다. 플레이어와 그리드 카드는 재생되기 전까지 비디오의 포스터를 보여줍니다. 포스터가 실제 타이틀 카드인 비디오를 선택하고, 검은색 첫 프레임은 피하세요.
  • 주소 변경 (edit_interactive_site with prefix)은 이전 이름을 유지하고 일정 기간 동안 리디렉션합니다. 가볍게 변경하지 마세요.
  • 취미 계정은 거부 사유와 함께 거부됩니다. 명확히 말하고, 우회하지 마세요.

Individual skills in this repo

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

vidmoat/caption-styling

Style, time and place captions and subtitles so they read on a phone with the sound off. Sets line length, reading speed, cue timing, size, contrast and platform safe zones, and checks SRT or VTT files against them. Use when the user wants captions or subtitles added, restyled, fixed or made accessible, says captions are too fast, too small or hidden under app buttons, or is preparing TikTok, Reels, Shorts or YouTube video, even if they only ask to "put what I say on screen".

vidmoat/layered-motion

Motion graphics people can edit afterwards: compositions of layers with keyframes, After Effects style. Use for lower thirds, animated titles, kinetic type, stat reveals, logo stings and callouts that the person may want to retime or restyle by hand, and when a composition is already on the timeline.

vidmoat/motion-graphics

Designed graphics with HTML elements, animating the objects inside them on the timeline clock. Use for animated stat cards, infographics, diagrams, UI mockups, logo stings, or moving an object inside a graphic.

vidmoat/video-essayist

Video Essayist specialist, tagged @video-essayist or consulted for script-led commentary and analysis: narration locked first, every line matched to a visual that proves it, short annotated clips, quotes with sources, thesis by 60 seconds, chapters. Use when the user tags @video-essayist or asks for a video essay, film analysis or commentary edit.

vidmoat/wedding-filmmaker

Wedding & Event Filmmaker specialist, tagged @wedding-filmmaker or consulted for wedding and event highlight films, teasers and vertical teasers: the couple's own words as the spine, cut to licensed music, slow motion only on peaks, true skin and an unclipped dress. Use when the user tags @wedding-filmmaker or asks for a wedding or event highlight video.

관련 스킬