AlexAnsart/demo-studio / skills/demo-setup
demo-setup
VerifiedOne-time setup that analyzes the current project and configures it to use the film-demo / narrate / sync-narration / produce-video skills — detects the dev server and framework, asks only when necessary, generates demo.config.json and .env entries, vendors the recording engine and project helpers, and scaffolds a first demo from reference patterns. Use when the user asks to set up, configure, or install demo-studio / video-recording skills for this project, or before running produce-video for the first time in a new codebase.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.2 KB |
| examples/assistant-panel/script.md | markdown | 1.3 KB |
| examples/create-item/script.md | markdown | 729 B |
| examples/search-flow/script.md | markdown | 1.2 KB |
| references/agent-integration.md | markdown | 2.2 KB |
| references/beat-plan.md | markdown | 1.4 KB |
| references/narrated-compose.md | markdown | 1.2 KB |
| references/script-format.md | markdown | 1.4 KB |
| references/when-to-ask.md | markdown | 2.0 KB |
| scripts/check-setup.mjs | script | 1.5 KB |
| templates/auth.mjs | script | 2.0 KB |
| templates/paths.mjs | script | 882 B |
| templates/run.mjs | script | 4.6 KB |
references/when-to-ask.md
View on GitHub# When to ask the user (and when not to)
**Default: infer and proceed.** Only interrupt when a wrong guess would waste a
recording take or leak bad credentials.
## Never ask
| Detected | Action |
|----------|--------|
| Vite + `scripts.dev` on port 5173 | `baseUrl: http://localhost:5173`, `devCommand` from package.json |
| Next.js default | `baseUrl: http://localhost:3000` |
| Static `index.html`, no server | Record via `file://` — no dev server question |
| No `/login` route, no auth middleware hints | `auth.loginRequired: false`, omit auth block from config |
| User said "silent" / "no voice" / no ElevenLabs key in env | `narration.provider: "none"` |
| Monochrome / dark UI | `frame.preset: "studio-dark"` |
| Light SaaS marketing site | Offer `clean-light` only if the UI is clearly light-first |
## Ask only when necessary
| Situation | Question |
|-----------|----------|
| Multiple possible dev ports / monorepo | "Which URL should demos open — A or B?" |
| Login page exists OR user said "authenticated flow" | "Do demos need to log in? If yes I'll inspect the login form for selectors." |
| Selectors not obvious after DOM inspect | "Confirm email field is `#email` / submit is `button[type=submit]`?" |
| User wants narration but no `ELEVENLABS_API_KEY` | "Set the key in `.env` or switch to silent mode?" |
| User wants narration + key present | "Which voice name from your ElevenLabs library?" (default from config if they don't care) |
| User already described the full demo flow | **Do not** ask "what should the demo show?" — pre-fill `script.md` |
## Prefer reading over asking
Before asking about selectors or URLs:
1. Read `package.json`, framework config, `.env.example`.
2. If the dev server is not running, start it (`devCommand` from config).
3. Open the login page once and read accessible labels / `id` / `data-testid`.
4. Read `references/script-format.md` and match the user's request to the closest
`examples/` pattern — scaffold from that, don't start from a blank template.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |