agentsope/SkillAlchemy / skills/agentsope-ai-video-director
agentsope-ai-video-director
UnverifiedDirect and implement programmatic videos from a natural-language sentence: brief, shots, style, timeline, assets, engine-specific coding prompts, draft, review and repair. Use when asked to make a video, product launch, explainer, Reel/Short, kinetic typography or docs-to-video with HyperFrames, Remotion or Motion Canvas, or to improve an existing code-video project. 一句话视频制作与导演工作流。
examples/product-launch.md
View on GitHub# Synthetic product announcement · 15 seconds
Authored complete application under C01–C07. This invented announcement does not apply P07 Tidy choreography, P03 banknotes, P04 READY collision treatment or another Scoped creative case to a novel product.
## Input, facts and assumptions
Input: “做一个 15 秒的 AI 产品发布短片,科技感、节奏快、竖屏。” Intent: a technology announcement draft for general viewers. Supplied constraints: 15 s, portrait, fast rhythm and technology mood. Product identity/features/proof/logo/date/link are unknown. “AI 产品”, “界面示意”, “功能信息待确认”, “链接待提供” are labeled synthetic draft copy, not product facts. Reversible package defaults: 9:16, 1080×1920, 30 fps, Chinese copy, silent evaluation draft and unspecified vertical feed. These exact values are not research-validated creative optima.
## Director plan and timeline
| Shot | Half-open seconds / frames at 30 fps | Subject/action | Framing and layout | Copy | Transition |
|---|---|---|---|---|---|
| S1 | [0,3) / [0,90) | One outline card resolves | Portrait close-up centered; title above, placeholder below | AI 产品 / 演示占位 | Inner-card 0.5 s opacity reveal |
| S2 | [3,7) / [90,210) | Neutral tiles enter around card | Medium view, card moves upward; tiles stay within central plane | 界面示意 / 演示占位 | Short inner-tile entrances |
| S3 | [7,11) / [210,330) | Central panel expands and settles | Frontal panel; generous copy space | 功能信息待确认 | Bounded inner-panel scale |
| S4 | [11,15) / [330,450) | Card and title settle for final hold | Stable wide portrait arrangement | 了解更多 · 链接待提供 / 演示占位 | Hold final 1.5 s |
Closure: 3+4+4+4=15 s; 450 frames, last 449. Background #091018, text #F4F7FC, accent #49DCE8; title 64 px, labels 32 px, inset 96 px are authored style tokens. No actual placement is known; the inset is not an organic/social safe-zone rule. If the delivery is specifically TikTok auction in-feed, use the actual overlay/anchor template within P15 and check that placement preview.
Asset ledger: original code-drawn card/tiles (authored, evaluation use); synthetic text (authored, marked placeholder); system font rendering (no font binary distributed; actual selected font permission remains to be recorded if bundled later). No real logo, screenshot, music or voice supplied. Audio/captions: silent draft assumption; no narration captions. Rights confirmation for public product delivery remains unknown until product/media and engine use are established.
## Conditional engine route and full coding prompt
Preferred authored evaluation route: HyperFrames 0.8.142 only after Node ≥22, local browser/FFmpeg, exact package and intended-use rights are confirmed. This is a conditional route, not an availability claim. Remotion 4.0.534 server is an alternative only after its exact tools and pinned-v4 eligibility basis are recorded. Unknown company production eligibility cannot be called eligible. Motion Canvas requires its released 3.17.2 local editor/exporter route; no headless render command is inferred. With no exporter, deliver the concrete plan/prompt/code state.
The full detailed coding-agent prompt is [hyperframes-prompt.md](hyperframes-prompt.md). It contains this application's complete shot/style/copy/timing, root metadata/GSAP registration, readiness/ownership rules, exact current CLI, artifact probe, acceptance/repair/handoff requirements. Send its complete “Prompt to the coding agent” text with this facts/rights ledger. Do not truncate it to a broad “make a launch video” sentence. If selecting Remotion instead, compile this same director plan under P21/P22/P24; use 450 total frames and the exact shot ranges above, while retaining the v4 eligibility gate and [server prompt profile](remotion-prompt.md).
## Implementation, QA, repair and current state
Expected implementation: original project-local source, all four scenes, labeled placeholders, lock/version record, actual strict export if tools/rights permit, retained command logs, probe JSON and sampled/consecutive boundary frames. No implementation or video is included with this example.
Static QA: verify finite duration/root IDs, seconds, completed timeline, owned namespaces, fact labels, exact pins and layout tokens. Render QA: probe actual 15 s/1080×1920/30 fps file, inspect mounting/resource warnings, numbers/copy/overflow and repeated seek equality. Full viewing is needed for rhythm; stills do not prove “fast” works. If a real preview shows cropped copy, revise the authored text box or type size and recheck the actual problem frames; this is C06 repair of this specification, not a promoted Scoped recovery. If export is absent, record the dependency gap and leave the video unclaimed.
Current example state: plan_available=pass (this document); code_available/static_checked/preview_observed/encoded_artifact_available/technical_probe_passed/sample_frames_reviewed/full_motion_reviewed/reproducibility_scope=not_executed; audio_listened=not_applicable solely for this explicitly silent draft; rights_confirmed=unknown for final intended use. Nine QA dimensions are review requirements, not passed results. See [checklist](../tests/quality-checklist.md) and [actual output contract](../tests/manual-review.md).
## Complete authored coding-agent prompt
Create a project-local silent evaluation draft from this plan. Target: 15 seconds, 1080×1920, 30 fps, HyperFrames **0.8.142**. Confirm the installed exact version, Node ≥22 and local browser/FFmpeg availability; retain the lock/tree and intended-use rights basis. Do not download a logo, music or external font. The fictitious “AI 产品 / 演示占位” text demonstrates announcement layout and makes no feature claim. Product identity, features and destination link remain unknown.
Create one standalone direct-body composition with matching `data-composition-id="launch-demo"`, `data-width="1080"`, `data-height="1920"`, finite root `data-duration="15"`. The root duration must exist before scripts execute. Use a local authorized GSAP dependency and `gsap.timeline({paused:true})`; finish the whole timeline before assigning `window.__timelines[compositionId] = timeline`. If setup waits for resources, register only at the end. Timed clips have `data-start`/`data-duration` in **seconds**. Keep framework namespaces and readiness flags intact; use application-specific IDs/namespaces, and declare pending application computation through `__hf.buildReady` with unique promise keys. Duration is not resource readiness.
Build the following exact authored visual plan. Background #091018; text #F4F7FC; cyan accent #49DCE8. Title 64 px and supporting labels 32 px at this evaluation size. Use 96 px working inset as a composition token; it is not a platform safe-zone claim. Each shot contains one primary focus and a visible “演示占位” label. S1 [0,3): reveal a rounded outline card, centered portrait close-up, copy “AI 产品”. Fade its inner card from opacity 0 to 1 during the first 0.5 s and hold. S2 [3,7): move the inner card upward within its visual plane and reveal three neutral tiles with “界面示意”; use no metrics or feature names. S3 [7,11): expand an inner panel into the central area and hold “功能信息待确认”. S4 [11,15): hold “了解更多 · 链接待提供” with the card stable, leaving a final 1.5 s readable hold. These timings and style tokens are authored requirements, not distilled creative rules.
Animate inner visual elements. Let the framework own timed-clip visibility and video/audio clock; do not animate timed-clip `visibility`/`autoAlpha`, and do not manually play/seek media. Do not import Remotion frames, Sequence, React hooks or Motion Canvas generator APIs. Seek state must depend on requested time, not wall-clock timers or prior playback. Preserve all facts/unknowns/default labels and the asset ledger in the handoff.
Run these separately from the directory containing the pinned local executable, replacing project/output paths only:
```sh
./node_modules/.bin/hyperframes --version
```
```sh
./node_modules/.bin/hyperframes check <project-dir> --at 0,3,7,11,14.5 --json
```
```sh
./node_modules/.bin/hyperframes snapshot <project-dir> --at 0,3,7,11,14.5 --no-end --describe false
```
```sh
./node_modules/.bin/hyperframes preview <project-dir> --background
```
After eligibility/dependencies are established, strict evaluated export is:
```sh
./node_modules/.bin/hyperframes render <project-dir> --output <output.mp4> --fps 30 --workers 1 --no-best-effort --frames-cache-dir off
```
```sh
ffprobe -v error -show_format -show_streams -of json <output.mp4>
```
The one-worker/strict/cache-disabled choices reproduce an admitted validation profile, not a speed recommendation. Inspect actual file duration, dimensions, fps and audio absence. Inspect visible mounted frames and resource warnings; clean lint does not prove layout or complete assets. Check consecutive frames around 3,7,11 s for unintended flashes/overflow against the authored layout. Compare repeated seeks at the same times. Repair observed layout defects against the supplied shot plan, rerun affected snapshots/probes, and record the change. Do not import a film-local crown, banknote payoff, caption offset, pen treatment or source-note threshold as a new rule.
Deliver source paths, exact engine/lock information, the actual artifact path if one exists, commands/results, QA evidence and limitations. Static/frame samples establish only their coverage. Full-motion pacing requires actual viewing; no audio listening is required only because this particular evaluation draft explicitly requests silence. Report all C07 states separately. If export is unavailable, keep encoded_artifact_available not_executed and explain the concrete dependency gap.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |