使い方
- インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
- 必要なツール、認証情報、対応環境を原文で確認します。
- 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/alexansart/demo-studio --skill demo-setup開始前の確認
- 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
- スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。
Demo setup
Turns a generic install of film-demo / narrate / sync-narration / produce-video into a working pipeline for this specific project. Run once per project (re-run when URL, auth, or narration settings change).
Read on demand (do not paste all into chat):
| File | When |
|---|---|
references/when-to-ask.md | Before asking the user anything |
references/script-format.md | Scaffolding script.md |
references/beat-plan.md | Narrated videos — sizing holds |
references/narrated-compose.md | Compose flags after record |
references/agent-integration.md | User asks how Cursor / Claude Code invoke skills |
examples/create-item/script.md | Simple form + list payoff |
examples/search-flow/script.md | Nav → query → scroll results |
examples/assistant-panel/script.md | Side panel + tool wait bracket |
templates/run.mjs | Starting point for demos/<slug>/run.mjs |
What this produces
<project root>/
├── demo.config.json
├── .env # gitignored — API key + demo login only
└── demos/
├── _engine/ # vendored copy of film-demo/scripts/*.mjs
├── _lib/ # paths.mjs, auth.mjs (from templates/)
└── <first-demo-slug>/
├── script.md
└── run.mjs_engine/ = recording/zoom/guardrails library (same code as film-demo/scripts/). _lib/ = thin project helpers (render dirs, off-camera login) — patterns reused across every demo in this repo.
Steps
1. Detect the stack
Read package.json, framework config, existing .env.example. Infer baseUrl and devCommand. See references/when-to-ask.md — do not ask if inference is confident.
2. Ask only when necessary
Login selectors, ambiguous ports, narration voice — only when detection fails or the user explicitly wants narration without a key. Default narration to "none".
3. Write demo.config.json
Use demo.config.example.json at the demo-studio repo root as the schema. Omit auth when loginRequired: false. Never put secrets in this file.
4. Write / update .env
Only the vars referenced by demo.config.json. Confirm .env is gitignored.
5. Vendor the recording engine
Copy the installed film-demo skill's entire scripts/ folder → <project>/demos/_engine/. If not installed: npx skills add AlexAnsart/demo-studio --skill film-demo --copy
6. Copy project helpers
Copy from this skill's templates/ → <project>/demos/_lib/:
paths.mjs—nextRenderDir,logRunauth.mjs— login +buildDemoSessionfromdemo.config.json+ env
Skip auth.mjs usage in scaffolded run.mjs when loginRequired: false.
7. Scaffold the first demo
Pick the closest examples/*/script.md pattern to what the user described (create-item, search-flow, assistant-panel). Copy/adapt it to demos/<slug>/script.md.
Copy templates/run.mjs → demos/<slug>/run.mjs. Replace TODO selectors, navigation paths, and beat plan comment. Match the Show section exactly.
If the user did not describe a flow yet, scaffold create-item as the default.
8. Verify
node <demo-setup-skill-dir>/scripts/check-setup.mjs
node demos/_engine/test-engine.mjsBoth must pass. If ffmpeg/ffprobe missing, stop — nothing downstream works.
Deliverable
Report: inferred baseUrl, login on/off, narration provider, preset, scaffold path, and which example pattern was used. Point the user to references/agent-integration.md for how to invoke produce-video in Cursor or Claude Code. Remind them to fill .env before narrated or login-gated runs.

