# Manual extraction and packaging

Extract a reusable `.motion` template from a finished video code project on your computer. Preserve animation and sound, turn the original copy and media into real inputs, then package, inspect and try new content.

Manual operation requires **Node.js 22 or later**. See the downloaded bundle’s `BUILD.json` for the current tool version and file digest.

## Extraction and packaging

1. **Inventory source effects.** Account for the selected scenes, backgrounds, transitions, action sounds and dependencies, including unresolved coverage.
2. **Expose real inputs.** Connect text, presenters and portfolio media to parameters while retaining the original style and animation methods.
3. **Record provenance and licenses.** Remove private content and credentials, declare the actual authoring tool and retain licenses for distributed resources.
4. **Write usable guidance.** Explain purpose, capacity, media roles, duration, supported languages and aspect ratios so assistants can use new content.
5. **Package and exercise it.** Run static checks, then make a new video in a clean instance and check actual audio, captions, animation meaning and visuals.

The included `references/authoring.md` covers the full workflow, including Windows paths, original audio, ASR timing evidence and alternating corner time and animated decoration. Static inspection alone does not establish complete extraction or finished-video quality.

## Download and use

[Download MotionGit Skill](https://motiongit.com/skill/motiongit-skill.zip), extract it into a new directory, and read `motiongit/SKILL.md` and `references/authoring.md`. Preserve any edits before replacing an existing installation.

Keep your original project and save a separate package output. Preview and rendering dependencies follow the template’s declared entry.

## Local commands

Run from the extracted `motiongit` directory. Quote project and output paths that contain spaces:

```sh
node scripts/motion.mjs --version
node scripts/motion.mjs scan TEMPLATE_DIR
node scripts/motion.mjs pack TEMPLATE_DIR OUTPUT.motion
node scripts/motion.mjs inspect OUTPUT.motion
```

Scanning, packaging and static inspection require no separate npm installation. Preview and rendering dependencies come from the template's actual entry point. `inspect` uses the rules bundled with the downloaded CLI; the website checks and reviews uploads again.

## Authoring provenance and personal downloads

Declare the actual authoring tool, client and model, and record packaging separately. Claude is recommended, but neither internal work nor user uploads are restricted by tool name. Acceptance depends on the actual result and authorization. Do not rewrite provenance to pass a check.

Authors upload **source packages without personal credentials**. The website adds each recipient's own credential and signatures when they download a template. A personal download is not an author source package for re-upload.

Making a video from a downloaded `.motion` normally does not require this author skill. Read the package's `00-START-HERE.md`, verify its bundled helper and follow that entry point. The verified helper uses the original package credential; it does not need to be saved separately or pasted into a conversation.

## Producing HTML/Canvas templates

The bundled entry includes an `html-canvas/1` renderer, supporting integer-frame `renderFrame` and legacy seconds-based `seek`. Use it to check dependencies, validate new inputs, preview and export MP4 without writing another renderer. The included `references/html-canvas.md` provides commands and music binding; the current implementation supports self-contained, fixed-duration templates.

## Checking animation in the new video

Map the effects actually provided by the template to user content and output intervals. Retain complete sequences in fixed animation templates; use suitable component effects as fully as their meaning and capacity allow, recording omitted effects and reasons. Check moving morph/transition midpoints in the encoded video. A poster, static samples or successful decoding alone does not establish motion reuse. The included `references/motion-coverage.md` covers the checks and playable review delivery; personal package first-read and bundled guidance carry the same requirement.

## Updating an existing template

The bundled helper can check for updates for free. After the user's confirmation, save and verify a new package while preserving the old package and project. Credential, license and download availability follow the service's actual response. See the downloaded `SKILL.md` for exact commands and compatibility recovery.

[Current format specification](https://motiongit.com/spec) · [Upload your work](https://motiongit.com/publish)