Communitygithub.com

ARYAN2302/liquid_researcher

プロカメラ風HUDモックアップテンプレート — 全画面黒背景で実動画をラップし、コーナーブラケット、トップステータスバー、サイドAF/露出カラム、ボトムタイムコード+絞り/シャッター/ISO行、垂直8フィルターホイール、アニメーション照準器を表示。映画撮影監督のポートフォリオ、カメラアプリデモ、LUTパックプレビュー、フィルタールックの試聴に最適です。

liquid_researcher とは?

このスキルは、プロフェッショナルなカメラのビューファインダーを模したHUDオーバーレイを実際の動画に重ねるHTMLテンプレートを生成します。対応プラットフォームはWebブラウザで、主にClaude CodeやCursor等のAIエージェントがコード生成時に使用します。ユーザーは動画URLまたはサンプル動画を指定でき、8種類のフィルタールック(ログ、REC709、KODAK2383等)をCSSフィルターで切り替えられます。HUDにはライブタイムコード、バッテリー残量表示、パルス照準器、フィルター切替時のフラッシュエフェクトが含まれ、すべて実装必須です。入力が「脚本」「ストーリーボード」など誤ったリクエストの場合は拒否し、正しいスキルを提案する三重の事前チェックを備えています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ARYAN2302/liquid_researcher/tree/HEAD/skills/design/design-templates/video-shortform

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル README より

ドキュメント

動画ショートフォームテンプレート

カメラHUDモックアップで、実際の映像素材をプロ用カメラ(RED / ARRI / Blackmagic / Sony Cine風)のビューファインダー風クロームでラップし、ユーザーが8種類のフィルムエミュレーションルックを試聴できるようにします。

このテンプレートは、TikTok / Reels / 视频号 / 抖音のソーシャルモックアップではありません。ストーリーボードではなく、ショットリストでもなく、分镜 / 脚本 ドキュメントでもなく、縦型ビデオ広告ポスターでもありません。


⚠️ 3つの事前確認ゲート — コードを書く前にすべてクリアすること

ゲート1 — これは本当にHUDの仕事か、それとも脚本/ストーリーボードの仕事か?

以下のトリガーワードがある場合、このスキルは不適切なので拒否してください:

ユーザーの発言実際に欲しいもの正しい対応
短视频脚本 / 视频脚本 / script docVO付き・時間指定のショットバイショットテキスト拒否し、ドキュメントテンプレートまたは wireframe-sketch を提案
分镜 / storyboard / shot listフレーム単位のサムネイル+説明拒否し、ストーリーボードレイアウトを提案
短视频封面 / 视频封面 / video cover静止画像 / ソーシャルカード拒否し、social-card-* スキルを提案
视频号/抖音/小红书视频卡プロフィール・いいね・コメント付きフィード風モックアップ拒否し、ソーシャルカードを提案
视频海报 / video poster静止印刷風ポスター拒否し、social-card-image-led を提案
调色 demo / LUT 预览 / 滤镜对比 / cinematographer portfolio / camera-app demo / 拍摄取景器 / viewfinder✅ このスキルが適切進めて良い

ユーザーの言葉が「脚本 / 拍摄 HUD」で曖昧な場合は、停止して質問すること:

「あなたが求めているのは (a) 撮影ビューファインダーHUDで実動画をラップして調色・レンズを表示するものですか?それとも (b) 動画脚本・ストーリーボードのドキュメントですか?このスキルは (a) のみ対応しており、(b) の場合は別のスキルに切り替えます。」

推測しないでください。間違ったスキル=全面的な書き直しです。

ゲート2 — 動画はどこから来るのか?

クロームは実際の <video> 要素をラップします。 内部に「[视频画面]」と書かれた <div> は受け入れられません — それはB48がやらかしたことで、このテンプレートの意味が完全に失われます。

決定木:

  1. ユーザーが動画ファイル/URLを指定した場合 → そのまま <video src="..."> で使用
  2. ユーザーが何も指定せず、サンプル動画で良い場合 → 下記のホットリンクリストから1つ選び、URLを <video src> に貼り付け、一文「サンプル素材:Big Buck Bunny / 公開テスト動画、ご自身の素材に置き換えても同様の効果が得られます」を追加
  3. ユーザーがオフライン/自己完結型を希望する場合 → curl -L -o sample.mp4 <hotlink> をケースフォルダ内で実行し、<video src="sample.mp4"> を使用
  4. 不明な場合 → 停止して、1/2/3のどれを希望するか質問

ホットリンクリスト(公開サンプル動画、2026年6月時点で200 OK確認済み)

この優先順位で選択してください。歴史的に有名な「Google Cloud gtv-videos-bucket」のURLは使えません(匿名アクセスが取り消されました)— 広く引用されていても使用しないでください。

# Mozilla MDN — 最も信頼性が高く、CORS対応、h264
https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4   # ~30秒、16:9、CC0 花のクローズアップ

# test-videos.co.uk — テスト用ファイル専用、複数サイズ
https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/720/Big_Buck_Bunny_720_10s_1MB.mp4   # 10秒、720p、~1MB
https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/360/Big_Buck_Bunny_360_10s_1MB.mp4   # 10秒、360p、~1MB 小型フォールバック

# w3.org — 映画風トレーラー、長めの再生
https://media.w3.org/2010/05/sintel/trailer.mp4                            # Sintelトレーラー、~52秒、映画風16:9

# W3Schools — 有名で最も安定
https://www.w3schools.com/html/mov_bbb.mp4                                 # ~10秒 BBBクリップ、h264
https://www.w3schools.com/html/movie.mp4                                   # 汎用テストクリップ

使用前に確認が必要な場合: curl -sIL -o /dev/null -w "%{http_code} %{content_type}\n" <url> — 200 video/mp4 を期待。403 / 404 / 000が返った場合はリストの次のURLにフォールバックしてください。使えないURLを出荷しないでください。

必須の <video> 属性(これがないとほとんどのブラウザで自動再生が起動しません):

<video src="<hotlink-or-local>"
       autoplay muted loop playsinline
       preload="auto"
       style="width:100%;height:100%;object-fit:cover">
</video>

muted はChrome/Safari/モバイルでの自動再生に必須です。playsinline はiOSで動画が全画面表示されるのを防ぐために必須です。

ゲート3 — フィルターホイールの中身は?

8つのフィルターが標準数です(リファレンスでは8)。それぞれについて宣言すること:

  • 表示名(3~6文字、例:KODAK 2383、FUJI 3510、LOG、REC 709)
  • 動画に適用するCSSフィルターレシピ:filter: contrast(1.1) saturate(.85) sepia(.15) hue-rotate(-5deg) ...
  • オプション:フィルター有効時にHUDで更新する対応カメラ設定デルタ(F値 / シャッター / ISO / EV)

ユーザーが指定しなかった場合、デフォルトとして以下の8つを使用します(一般的なLUTパレット空間をカバー):

01 LOG         filter: contrast(.85) saturate(.7) brightness(1.05);
02 REC 709     filter: none;                       /* ベースライン */
03 KODAK 2383  filter: contrast(1.1) saturate(.9) sepia(.08) hue-rotate(-4deg);
04 FUJI 3510   filter: contrast(1.05) saturate(1.1) hue-rotate(8deg);
05 ARRI K1S1   filter: contrast(1.15) saturate(.85) brightness(.95);
06 TEAL ORANGE filter: contrast(1.2) saturate(1.2) hue-rotate(-12deg);
07 B&W         filter: grayscale(1) contrast(1.15);
08 BLEACH BP   filter: saturate(.3) contrast(1.25) brightness(1.05);

必須HUDインタラクション — これらはすべて省略不可

どれか一つでも欠けていると、成果物は不完全です。B48は6つすべてを欠いていました。

  1. 実際の <video> 要素(ゲート2で強制)。div、ポスター画像、背景画像ではありません。
  2. フィルターホイールの切り替え — スクロールホイール + ArrowUp/ArrowDown + 各ドットのクリックで8つのフィルターを巡回。アクティブフィルターはレコードレッドで強調表示。
  3. 24/25 fpsで動作するタイムコード — HH:MM:SS:FF 形式、requestAnimationFrame 駆動、tabular-nums、動画ループに合わせてリスタート。
  4. 照準器のパルス — ゆっくりとした拡大縮小と不透明度のループ、アクセントストローク(レコードレッドであって緑ではない)、prefers-reduced-motion でアニメーション一時停止。
  5. フィルター切替時のブライトネスフラッシュ — フィルター変更時に動画上に80~120msの白いフラッシュ(露出再計測をシミュレート)。prefers-reduced-motion の場合はスキップ。
  6. バッテリー消費 — 右上のバッテリー残量表示が8~12秒ごとに1%ずつ減少、5%で停止、20%以下で赤色に変化。

オプションだが推奨:RECパルス(「録画中」に赤い点が1Hzで点滅)、フィルター変更時のフォーカス確認ビープ音、隅にヒストグラムグリフ。


固定ビジュアルルール — 代替不可

固定ルール値理由
背景純粋な #000#0a0a0aでもダークグレーでもない。黒のキャンバスがビューファインダーです。
前景タイプ#e0e0e0 / #fff明るいトーン1色のみ。
単一アクセントレコードレッド #ff3b30RECピル、アクティブフィルター、照準器、警告状態に使用。緑でも青でもティールでもありません — レコードレッドがこのテンプレートの視覚的シグネチャ全体です。
フォントスタック等幅のみ(SF Mono / JetBrains Mono / Menlo / IBM Plex Mono)HUD数値にサンセリフは不可。CJK文字オーバーレイは唯一のサンセリフ使用ですが、それ自体が稀です。
HUD不透明度副次的な読み取り値 ≈ 45%動画が主役であり続けます。
ボーダースタイル4つのコーナーブラケット、決して実線ボーダーにしない実線ボーダー=モニターフレーム、ビューファインダーではありません。
フィルターホイール垂直、約8ドット、右側水平カルーセル=ソーシャルUI、間違ったレジスターです。

アンチパターン(B48の失敗モードに対するセルフチェック)

  • <video> が欠落している、または <div> + テキストに置き換わっている → 拒否、ゲート2に戻る
  • アクセントカラーが #ff3b30 以外(例:緑、ティール、青) → 元に戻す
  • HUD数値が静的文字列(タイムコード、ISO、バッテリー) → ライブにする
  • フィルターホイールにインタラクションがない(スクロール/矢印/クリックハンドラーがない) → 接続する
  • 脚本 / 镜头 / VO / 旁白 のテキストブロックが重なっている → 間違ったスキル、ゲート1で仕事を拒否
  • ソーシャルUI(プロフィール、いいね、キャプション、音楽帰属) → 間違ったスキル、拒否
  • 中央に配置された再生/一時停止ボタン → これはビューファインダーです、削除
  • 複数のアクセントカラー → レコードレッドのみに戻す
  • HUD要素に対するグラスモーフィズム / グラデーション / グロウシャドウ → カメラクロームはフラット、削除
  • HUD読み取り値にサンセリフフォント → 等幅に変更
  • [ ]「未来的に見せる」ための黄色 / 琥珀 / シアンのHUD色合い → フラットな白/グレー + レコードレッドのみ
  • <video> に muted playsinline autoplay loop がない → 自動再生されない、追加する

必須読書

この SKILL.md を最初から最後まで読んでください。次に video-shortform.html を読んで、実際の実装パターン(コーナーブラケットのジオメトリ、タイムコード HH:MM:SS:FF の刻みロジック、8フィルターホイールのスクロール/キーボードハンドラー、照準器パルスのキーフレーム、バッテリー消費インターバル、フィルター切替時のブライトネスフラッシュ)を確認してください。

以下のものをコピーしないでください:

  • リファレンスのフォールバック動画URL(上記のホットリンクリストを使用)
  • プレースホルダーのフィルターメタデータ(ゲート3のデフォルトまたはユーザー指定を使用)
  • クラス名そのまま(プロジェクトに応じて名前を変更)

デザイン戦略

コーディング前に体験契約を確定する:

  1. ソース動画(ゲート2)— どの映像、どのアスペクト比、どの長さか?
  2. フィルターセット(ゲート3)— 8つすべての名前 + CSSフィルターレシピ
  3. HUDの誠実さ — どの数値がフィルター変更に反応し、どれが装飾か?
  4. アスペクト — デフォルトは16:9デスクトップ。縦9:16の場合、サイドカラムが混雑するので、HUDストリップを上下のみに切り替える

レイアウトの好み

推奨:

  • ピュアブラックキャンバス、等幅のみ、レコードレッドアクセント
  • 動画端から24~32ピクセルの位置に4つのコーナーブラケット
  • 副次HUDは約45%の不透明度で、映像が支配的になるように
  • 右側に垂直8フィルターホイール、約20ピクセルのドット
  • 控えめなフィルムグレイン ::after オーバーレイ(最大5~8%不透明度、乗算ブレンド)
  • タイムコードは下部中央、tabular-nums、他のHUD要素より大きく

避けるもの:上記の固定ルールとアンチパターンの表にあるすべて。


プラットフォーム / サイズ

全画面表示、ウィンドウアスペクトにレスポンシブ。16:9ソースでのデスクトップに最適。ポートレート動画でも動作しますが、サイドカラムが混雑するため、HUDストリップを上下に移動してください。モバイルではレンダリングされますが、キーボードでの巡回は機能しないため、フィルターホイールにタッチスワイプ上下を追加してください。

Individual skills in this repo

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

ARYAN2302/liquid_researcher

Generate a single-file Chinese atelier-style portfolio website (horizontal-row list + hover-reveal thumb interaction, art lishu typography "Alimama DaoLiTi" via CDN, light/dark theme, hash-routed detail pages). Takes a natural-language description of the studio (name, director, discipline, works) and outputs ONE working .html file. Runs in BOTH Claude Code (writes to ~/Desktop) and GLM / online chat (outputs HTML inline). Trigger phrases include "做个中式工作室作品集", "做个隶书作品集", "lishu-portfolio-gen ...", "做个白屋风格的作品集", or when user drags this skill folder into chat asking for an atelier-style site.

ARYAN2302/liquid_researcher

Chinese-market SaaS pricing page template — soft sky-blue glass-morphism, 4-tier card grid with one elevated "recommended" tier, monthly/annual toggle, FAQ accordion, ¥ pricing with Inter numerals, careful CJK linebreaking, ICP filing footer.

ARYAN2302/liquid_researcher

Premium calm-tech SaaS landing template — bilingual (CN/EN) literary voice over a dark forest-night palette with warm gold accent, Cormorant + Noto Serif SC, Three.js procedural forest hero, station-based scrolling narrative, custom cursor. Built for ambient-AI / creative-tool / philosophical SaaS, not loud commercial launch.

ARYAN2302/liquid_researcher

Premium pre-launch waitlist page template — dark charcoal canvas with subtle vignette, drifting portrait video-thumbnail cards, fade-up cascades, glass nav, live-updating join counter, single email form with success/error states. Built for creative-tool / AI / niche-SaaS invite-only launches with hushed exclusive tone, not loud growth-marketing.

ARYAN2302/liquid_researcher

Route design-related HTML artifact tasks to the right artifact skill, reference, design system generation, or export skill.

ARYAN2302/liquid_researcher

Implement text-to-speech (TTS) capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to convert text into natural-sounding speech, create audio content, build voice-enabled applications, or generate spoken audio files. Supports multiple voices, adjustable speed, and various audio formats.

ARYAN2302/liquid_researcher

Implement AI-powered video generation capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to generate videos from text prompts or images, create video content programmatically, or build applications that produce video outputs. Supports asynchronous task management with status polling and result retrieval.

ARYAN2302/liquid_researcher

Implement specialized video understanding capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to analyze video content, understand motion and temporal sequences, extract information from video frames, describe video scenes, or perform video-based AI analysis. Optimized for MP4, AVI, MOV, and other common video formats.

関連スキル