Communitygithub.com

インタラクティブサイト

誰かのインタラクティブ動画のためのホストサイト:ページ、ブロック、テーマ、公開。サイト、ポートフォリオ、リンクページとして利用します。

インタラクティブサイト とは?

このスキルは、VidMoatプラットフォーム上でインタラクティブ動画専用の個人サイトを作成・編集・公開するためのツール群を提供します。サイトは `https://{prefix}.interactive.vidmoat.com` にホストされ、動画を中心としたフレームとして機能し、訪問者は1画面以内でプレイヤーにたどり着けるように設計されています。主な操作は `get_interactive_site`(現在の状態取得)、`edit_interactive_site`(一括編集)、`publish_interactive_site`(公開・非公開)の3つのMCPツールを通じて行われ、アプリ内では `agentWorkspace` 経由で同様の操作が可能です。ワークフローは厳格で、事前にサイト情報を読み取ってから変更し、公開済みで共有設定された動画のみを使用し、テーマは1つだけ設定し、バッチ編集後にのみ公開するよう指示されています。また、カスタムコードの禁止、アクセントカラーの可読性チェック、ストーリーマップの公開制限など、多くの注意点が含まれており、ユーザー体験とプラットフォームの一貫性を保つためのガイドラインが詳細に定められています。

対応~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 にあるサイトは、ユーザー自身のインタラクティブ動画を、周りに余計なものを一切配置せずに表示するホームです。動画が主役であり、サイトはそのフレームです。すべてのページは、訪問者を1画面以内でプレイヤーに導く必要があります。

ツール: 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 を share: true で実行)。推測したり別の動画とすり替えたりしてはいけません。
  3. 名前は一度決める。 get_interactive_site に prefix: "名前" を指定して名前を確認し(制限: 1~2回の試行、アイデアを繰り返し提案しない)、その後 edit_interactive_site で create: {prefix, title} を実行します。ユーザー自身の名前やブランドを使用します。アカウントにつき1サイトです。
  4. 1つのテーマ。 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(見出し、1行、最も強い動画を video として、ボタン)、次に残りの動画の grid、次に説明(分岐する映画には story、text、about)、最後に cta または links。注目動画は1つだけ、3つではありません。
  6. ページは少数に。 ホームだけでも十分なことがよくあります。それが1画面以上になる場合にのみ films や about ページを追加します。setNav でそれらをリスト表示します。setHeader でタイトル、タグライン、images: true からのロゴを設定します。
  7. 編集は一括で。 1回の edit_interactive_site 呼び出しですべての ops(すべて適用されるか、まったく適用されない)を送信し、応答の 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 は画像ID を images: true から受け取ります。URL は不可です。
  • アクセントカラーは拒否されることがあります。 文字やページとのコントラストが低く読みにくい場合です。ダークテーマでは明るめのアクセント、ライトテーマでは濃いめのアクセントを試してください。
  • 制限は拒否され、切り詰められることはありません。 6ページ、1ページあたり12セクション、1グリッドあたり12動画、6ナビゲーションリンク、10リンク。見出しは90文字、本文は600文字。自分で短くしてください。
  • null は削除 を意味します。updateSection でオプションフィールドを削除する場合に使用します。省略するとそのまま維持されます。
  • 公開されたサイトは検索エンジンに見つかることがあります(サイトマップと動画データが付随します)。各ページの title と description は、見知らぬ人が検索したときのために記述してください。setSettings で indexing: false にすると、ユーザーが非公開にしたいときにサイトを検索対象から外せます。
  • ストーリーマップはゲームの楽しみを損ねます。 デフォルトでは冒頭とその選択肢のみを表示し、シーン数と結末数をカウントします。レッスンやガイドの場合にのみ reveal: "full" を使用し、ゲームやミステリーでは絶対に使用せず、秘密を約束するコピーの横にも配置しないでください。
  • ポスターは重要です。 プレイヤーやグリッドカードは、再生されるまで動画のポスターを表示します。ポスターが実際のタイトルカードであり、黒い最初のフレームではない動画を選んでください。
  • アドレスの変更(edit_interactive_site で 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.

関連スキル