nexu-io/openmotion

openmotion-video-to-template

使用 OpenMotion 将参考视频(纯动效或包含商品、真人、声音的混合视频)重建为可反复换内容的可编辑模板,交付源码、素材、预览、编辑说明与文件夹或 ZIP。仅在用户要求可复用模板时使用;按参考制作本次成片走 openmotion-recreate,使用已有模板出片或替换内容走 openmotion-template-to-video,原创走 openmotion-director。

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/nexu-io/openmotion --skill openmotion-video-to-template

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

OpenMotion Video to Template

This is the openmotion-video-to-template production entry, selected for a requested reusable template. Read shared context for the current scope and reuse available bodies without returning to the router. MCP-only clients use resources/read openmotion://workflow/video-to-template/start for this same file; follow supporting references only when needed. Revisions to an existing template draft use the shared edit workflow. A request to recreate a finished video without a reusable-template deliverable stays with openmotion-recreate.

Deliver a reusable native HyperFrames project with local assets and an actual preview. Keep controlled text, brand overlays, graphics and timing editable. When reference footage, product imagery or sound carries part of the film, reconstruct that role as a separate, replaceable asset in the same timeline.

Closely match the reference's pictures, composition, motion and pacing while preserving editability. Reproduce texture, depth and lighting present in the reference; do not add decorative effects merely to make it look more polished.

When a reference comes with change requests, deliver the faithful template first and apply those changes separately through openmotion-template-to-video; do not mix a remix into the faithful baseline.

Follow the shared material policy. Use the mixed-media workflow only when images, footage or audio need to be sourced or recreated. Code-only Motion never enters provider setup or generation.

Understand the requested result

Obtain and read the whole reference through the shared reference reading and measurement method before choosing implementation. Use its local sound checks when the active model's audio input is unavailable or unknown. Preserve the link's URL and the local copy's checksum.

Preserve the reference's content, wording, brand, composition and motion as they are; do not pre-substitute them. Content replacement happens later with openmotion-template-to-video.

Work independently on ordinary creative decisions. Where the reference is ambiguous, choose the most faithful reasonable option and record the choice and trade-off in TEMPLATE.md. If generation needs spend consent not covered by the task, follow the media Skill for the planned batch. If an input cannot be obtained or decoded, report the specific blocker.

Choose an editable representation

Apply the shared editable representation and text and fonts rules. A template's content stays editable for later replacement: keep wording, brand, images and named objects easy to locate, declare common edits as root variables, and make distinctive lettering settable for new words. Record font substitutions and other approximations in TEMPLATE.md.

Make and check the work

Read the pinned native authoring guide and runtime adapter. For a portable folder, create a separate working directory and use the pinned native CLI; this requires host filesystem/shell capabilities. For a managed project, reuse its projectId or create a carrier with openmotion_create_project: use projectType=referencevideo with an actual HTTP(S) referenceUrl or known referenceVideoId; for a local video use projectType=naturallanguage and record the local reference/checksum in requirements. Include requestId, title and requirements. Creation records the source but does not analyze or recreate the video. Read sources/current versions with openmotion_get_project, import supplied local files with openmotion_import_assets or adopt a selected workspace asset version as described by the media Skill, and save native text through openmotion_edit_project with projectId, requestId, expectedRevision and expectedVersionId. Read the new version after imports or GUI changes. Do not assume a catalog ID exists, write reserved metadata, or bypass managed-project version protection with direct filesystem writes.

Use the shared runtime and media-tool paths to read the guide and locate the CLI. Do not call openmotion_open_preview just to obtain paths: it runs lint and selects an existing project in Studio. Initial template packaging can run in the background; follow-up content edits apply the shared continuing-edit preview rules, with explicit background requests taking precedence. Use host capabilities to obtain and analyze video, make the comparison, and package an independent folder. Report a concrete capability gap if any of these steps is unavailable.

Use the shared measurements for questions that need exact timing, dimensions or layout, and record them in TEMPLATE.md. Use rebuild guidance for grouping, media and edit dependencies. For an unfamiliar or difficult visual system, a short representative segment can establish a useful approach before expanding the film; this is advice, not a mandatory extra stage.

Compare actual frames with the reference while developing, and apply the shared fidelity checks: bounded repair, hard cuts and edit dependencies. Record an issue that bounded repair does not resolve in TEMPLATE.md and move on.

Finish with technical checks and packaging and the portable project contract. Deliver the complete folder/ZIP, preview and cover, with one TEMPLATE.md inside. Do not require registration, a template ID or a custom content schema. Keep the reply short and in the user's words: absolute-path links to the preview, the template and the original-versus-template comparison; what can be changed; and where it still differs from the original. Technical check results stay in TEMPLATE.md; mention one in the reply only when it affects the user, such as a silent tail or a substituted font. Humans decide visual acceptance. Do not reject or repeatedly rework a deliverable solely because of a similarity score or your own taste.

Keep two checks separate: reference-to-rebuild uses diagnostics and human visual judgment; the package check confirms the unpacked ZIP renders elsewhere without missing files or creator-machine paths, with the frame rate, frame count and duration of preview.mp4. It is not a pixel comparison; do not spend repair rounds on invisible differences.

Guidance sources separates reviewed material, observed evidence and advice. Do not treat one sample or another product's documentation as a universal effect guarantee.

from this repository

More skills

All skills
nexu-io
Community

openmotion

Create and edit videos with OpenMotion, recreate a reference video, or adapt an editable template. Set up the local Studio and MCP connection when missing, then continue through the matching production workflow. Use for OpenMotion installation and first use; an already-selected specialist continues directly. Repository development does not trigger video production.

24h installs
825
GitHub stars
14.7K
Updated
Nov 22
nexu-io
Community

openmotion-director

Plan and create original motion videos and motion graphics with OpenMotion. Use for “做一个 motion 视频”、动效视频、动画短片、先构思视频怎么呈现, including esports recaps, explainers, product demos and brand films. Also use for narrative, motion or sound redesign and creative review. Execute established edits/exports with openmotion-production, editable templates with openmotion-template-to-video, reference reconstruction with openmotion-recreate and reusable templates with openmotion-video-to-template. Repository devel

1h installs
2
GitHub stars
13K
Updated
Nov 20
nexu-io
Community

openmotion-production

执行 OpenMotion 已有工程在既定创作决定下的局部修改、素材或音轨替换、预览、技术排错、导出与交付。重新设计叙事、动作或声画关系使用 openmotion-director;已有模板出片走 openmotion-template-to-video,参考作品复刻走 openmotion-recreate,视频转可复用模板走 openmotion-video-to-template。仓库开发与文档维护不触发影片制作。

1h installs
2
GitHub stars
13K
Updated
Nov 20
nexu-io
Community

openmotion-recreate

Recreate a reference video (a link or file) as the user's own film with OpenMotion: rebuild it as an editable OpenMotion project and hand it over open in the editor, keeping the original content or swapping in the user's copy, brand and assets. This includes small edits to the user's own finished video when no editable project for it exists. "Make one like this" and "I want this feel" both count as recreation. In a workspace with the user's product material, a bare link alone means "make one lik

1h installs
2
GitHub stars
13K
Updated
Nov 20