nexu-io/openmotion / library/design/skills/chat-motion-overlay
chat-motion-overlay
VerifiedGenerate configurable chat motion overlays from a transcript or screenshot, including plain bubble scenes, app-style chat containers, optional device frames, preset or uploaded avatars, nickname display rules, and transparent-video-ready Remotion bundles. Use when Codex needs to create reusable short-form chat clips for Douyin, demo videos, story reenactments, social-message proof scenes, or embeddable alpha overlays for Hyperframe and Remotion workflows.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.7 KB |
| agents/openai.yaml | config | 315 B |
| assets/examples/chat-transcript.txt | markdown | 273 B |
| assets/examples/config-wechat-phone.json | config | 363 B |
| assets/remotion-template/package.json | manifest | 689 B |
| assets/remotion-template/remotion.config.ts | script | 180 B |
| assets/remotion-template/src/chatSpec.ts | script | 426 B |
| assets/remotion-template/src/components/types.ts | script | 1.1 KB |
| assets/remotion-template/src/index.ts | script | 105 B |
| assets/remotion-template/tsconfig.json | config | 307 B |
| references/config-schema.md | markdown | 2.2 KB |
| references/input-format.md | markdown | 2.9 KB |
| references/output-modes.md | markdown | 1.6 KB |
| references/question-strategy.md | markdown | 2.5 KB |
| references/test-matrix.md | markdown | 6.5 KB |
| references/test-report.md | markdown | 7.1 KB |
| scripts/build_chat_overlay_spec.py | script | 10.4 KB |
| scripts/prepare_chat_overlay_bundle.py | script | 4.4 KB |
| scripts/run_test_matrix.py | script | 21.5 KB |
references/test-matrix.md
View on GitHub# Test Matrix
This matrix covers the configurable surface of `$chat-motion-overlay`.
## Goals
- Validate transcript to spec generation
- Validate bundle preparation and asset copying
- Validate template type safety
- Validate representative rendering for each major scene family
- Catch invalid config combinations early
- Validate group chats can assign avatars per participant instead of only per side
- Validate uploaded avatar asset names remain unique when participant slugs collide
- Validate bubble-only overlays keep right-side rows explicitly right-aligned
- Lock down the question strategy so incomplete requests are handled consistently
- Validate transcript avatar hints are checked against preset keys before use
- Validate `uploadPath` is rejected when `avatarMode` is `preset`
- Validate config participant presets override transcript avatar hints
- Validate `--force` rejects dangerous output directories instead of deleting them
- Reject the unsupported bubble-only plus phone-frame combination before rendering
- Validate rendered frames across a message `appearAt` boundary, not only a later still
## Covered Dimensions
- `container`: `none`, `wechat`, `telegram`, `messenger`
- `avatarMode`: `preset`, `upload`, `mixed`
- `deviceFrame`: `none`, `iphone-dynamic-island`
- `nicknameMode`: `hidden`, `first-message-only`, `always`
- `deliveryFormat`: `mov`, `webm`, `json`, `remotion`, `hyperframe`, `preview`
## Cases
1. `default_wechat_phone_preset_hidden`
- Container: `wechat`
- Avatar mode: `preset`
- Device frame: `iphone-dynamic-island`
- Nickname mode: `hidden`
- Delivery: `MOV(透明背景,可直接导入剪映 / PR / FCP 叠加)`
- Render frames: `14`, `15`, `120` to cross the first message `appearAt`
2. `plain_bubbles_no_frame_first_message`
- Container: `none`
- Avatar mode: `preset`
- Device frame: `none`
- Nickname mode: `first-message-only`
- Delivery: `Remotion 工程(适合继续编辑和拼装)`
3. `telegram_no_frame_always`
- Container: `telegram`
- Avatar mode: `preset`
- Device frame: `none`
- Nickname mode: `always`
- Delivery: `WebM(透明背景,适合网页 / 浏览器播放)`
4. `messenger_phone_hidden`
- Container: `messenger`
- Avatar mode: `preset`
- Device frame: `iphone-dynamic-island`
- Nickname mode: `hidden`
- Delivery: `MOV(透明背景,可直接导入剪映 / PR / FCP 叠加)`
5. `upload_phone_always`
- Container: `wechat`
- Avatar mode: `upload`
- Device frame: `iphone-dynamic-island`
- Nickname mode: `always`
- Delivery: `MOV(透明背景,可直接导入剪映 / PR / FCP 叠加)`
6. `mixed_wechat_phone_first_message`
- Container: `wechat`
- Avatar mode: `mixed`
- Device frame: `iphone-dynamic-island`
- Nickname mode: `first-message-only`
- Delivery: `Hyperframe 工程(适合作为模块继续复用)`
7. `json_spec_only`
- Container: `wechat`
- Avatar mode: `preset`
- Device frame: `iphone-dynamic-island`
- Nickname mode: `hidden`
- Delivery: `JSON 数据(适合程序处理 / 自定义渲染)`
8. `group_multi_participant_distinct_presets`
- Container: `wechat`
- Avatar mode: `preset`
- Four speakers across left and right sides
- Expected: each participant can resolve to a distinct avatar
9. `invalid_upload_missing_side`
- Avatar mode: `upload`
- Missing one upload path
- Expected: fail with validation error
10. `invalid_mixed_without_upload`
- Avatar mode: `mixed`
- No upload path
- Expected: fail with validation error
11. `invalid_upload_missing_file`
- Avatar mode: `upload`
- Upload path points to a missing file
- Expected: bundle preparation fails fast with a clear missing-file error and leaves no generated `chatSpec.ts` leaking local upload paths
12. `invalid_participant_side_conflict`
- One participant appears on both left and right sides
- Expected: fail with validation error and ask for consistent participant side
13. `upload_slug_collision_unique_assets`
- Avatar mode: `upload`
- Two distinct speaker names normalize to the same slug
- Expected: generated participant ids and copied upload assets remain unique
14. `invalid_transcript_avatar_key`
- Transcript line includes a non-preset avatar key
- Expected: fail with validation error instead of silently falling back to a preset avatar
15. `invalid_preset_mode_upload_path`
- Avatar mode: `preset` but a participant config carries `uploadPath`
- Expected: fail with validation error
16. `config_preset_overrides_transcript_avatar_hint`
- Config preset differs from transcript avatar hint for the same participant
- Expected: generated spec uses the config preset, not the transcript hint
17. `invalid_force_dangerous_output_dir`
- `--force` targets a dangerous existing directory such as the skill root
- Expected: bundle preparation fails before any recursive deletion happens
18. `invalid_bubble_only_phone_frame`
- Container: `none`
- Device frame: `iphone-dynamic-island`
- Expected: fail with a validation error instead of generating a clipped phone-frame scene
## Pass Criteria
- Valid cases generate JSON spec successfully
- Valid bundle cases prepare output bundle successfully
- Generated bundle sanitizes machine-local upload paths out of `src/chatSpec.ts`
- Generated bundle passes `tsc --noEmit`
- Representative valid cases render a still frame successfully
- Group chat cases assign avatars by participant, not only by left/right side
- Uploaded avatar assets remain collision-proof for participants with colliding slug bases
- Bubble-only overlays explicitly use right-side row alignment in the generated template
- Participant side conflicts fail instead of rendering one person on both sides
- Invalid cases fail with the expected validation error
- Invalid upload-path cases fail during bundle preparation instead of silently falling back to preset avatars
- Transcript-provided avatar keys that are not in the preset library fail with a clear validation error
- `avatarMode=preset` configs that include `uploadPath` fail with a clear validation error
- Config participant presets take precedence over transcript avatar hints when both are present
- `--force` rejects dangerous output directories before deleting anything
- Advertised Remotion render scripts keep `src/index.ts` before the composition id
- `container=none + deviceFrame=iphone-dynamic-island` fails with a clear validation error
- Representative render coverage crosses at least one message `appearAt` frame boundary
- Question policy is documented with defaults, triggers, and user-facing wording
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: 471k | 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 |