map-motion SKILL.md skillA

map-motion from spacezephyr/map-motion is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add spacezephyr/map-motion/map-motion@git:20261009.683f73a

Pins git:20261009.683f73a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
spacezephyr/map-motion
Path
SKILL.md
Versions recorded
5
Latest version
git:20261009.683f73a, committed Oct 9, 2026
First version recorded
Oct 7, 2026
Size
12,106 bytes
Repository stars
77
License
a license file GitHub does not identify

地图动效视频:用高德地图(真实路线、行政区边界、标准/卫星瓦片底图)做旅行与解说视频里的地图动画,出竖屏/横屏 MP4 和 GIF。十四种镜头:地球俯冲定位(从地球放大到某地)、Vlog「我在这里」瞄准锁定+坐标卡、落点标注、公园/景区/校园地块轮廓描边与绕行、路线描线(驾车/步行/骑行/GPX,车随线走、里程表滚动、镜头跟车、海拔剖面)、飞线航线、行政区描边高亮、一对多辐射飞线、多站旅程(路线+邮戳+照片+返程;可换成卡通形象走路、到站拍照的 vlog 模式,配原创 BGM 和音效)、片尾照片墙、全景收束、标题卡、机位揭秘(咔嚓翻出照片,可做 Live Photo)、猜地点;另有 3D…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 地图动效 map-motion

> 子 skill:「找机位」(照片 → 机位揭秘视频)`photo-spot/`;3D 地形与光线推演 `map-3d/`;旅行 vlog(照片 → 卡通小人沿路线走、到站拍照、配乐)`travel-vlog/`。流程和坑在各自目录;本文件只讲引擎。

一份「镜头表」JSON → 编译(高德解析地名、取路线和边界、算镜头)→ 逐帧渲染(Chromium 画布 + ffmpeg)。

```sh
D=~/.claude/skills/map-motion/scripts
$D/make.sh 我的片子.json 成片.mp4 --gif 动图.gif           # 一键:编译 + 渲染
$D/make.sh 我的片子.json 静帧/ --stills 1,4.5,9            # 先抽几帧看构图(快)
```
首次使用:`uv run --with playwright playwright install chromium`;高德 key 见下。

## 工作流

1. **定内容**:问清地点/路线/日期/照片、发哪个平台(定 `size`)、要什么感觉(定 `style`)。不确定样式时,同一份 spec 换 `style` 各渲一帧给用户挑(至少三种)。
2. **写 spec**:从 `assets/examples/` 挑最近的一份复制改。镜头类型与全部参数见 [references/spec.md](references/spec.md)。
3. **编译并核对地点**:编译会逐个打印「地点 X → 高德解析结果(级别)[坐标]」。**每一行都核对**:同名地点会解析错(实测「香格里拉」曾被解析成某家酒店)。不对就换更具体的名字,或直接写坐标。
4. **抽静帧**:`--stills` 取每个镜头中段和结尾各一帧。输出末尾有**自动质检**(出画、文字互压、文字压照片、黑块):「质检:通过」就不用读图;报了问题,或要判断审美(构图、配色)时,才 Read 对应静帧。
5. **出片**:渲染整片(30fps 约每秒 2.5 帧画面;40 秒片子约 1.5–2 分钟),需要时加 `--gif`、`--audio`。长片放后台跑;结束只输出几行摘要(成片路径、时长、边渲边抽检的质检结论),`-v` 才打印逐段进度。中途看进度用 `python3 scripts/status.py`(一行),不要反复读日志。
6. **交付**:说清时长、文件位置、用了哪些真实数据(高德路线公里数等),以及哪些是示意。

## 镜头一览

| type | 效果 | 典型用途 |
|---|---|---|
| `globe` | 地球自转 → 俯冲到地点,落点弹标签 | 片头、地点引入 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add spacezephyr/map-motion/map-motion@sha256:d3848172be1eca9b

The line at the top of this page pins the label git:20261009.683f73a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_cnmot7a4gfzistre.svg)](https://markdownregistry.com/a/art_cnmot7a4gfzistre)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Oct 7, 2026 and Oct 9, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261009.683f73a latest2026-10-09 683f73a 12,106 BA view · diff
git:20261009.8aa7a532026-10-09 8aa7a53 11,477 BA view · diff
git:20261009.bec0f8e2026-10-09 bec0f8e 11,140 BA view · diff
git:20261008.7d995272026-10-08 7d99527 9,051 BA view · diff
git:20261007.ca5258e2026-10-07 ca5258e 8,194 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12106 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

spacezephyr/map-motion · 77 stars · license a license file GitHub does not identify · pushed 2026-10-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cnmot7a4gfzistre
GET https://markdownregistry.com/api/v1/resolve?ref=spacezephyr/map-motion/map-motion
GET https://markdownregistry.com/api/v1/blob/d3848172be1eca9b4cd8ba3e51a76bb5ff5a8e39b8d421a357e0b5e12f159790

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from spacezephyr/map-motion

map-3d SKILL.md skill
spacezephyr/map-motion · map-3d/SKILL.md · 3D 地形地图视频:真实立体山体(卫星贴图 + 高程)上做轨迹/路线/地点动画,竖屏 MP4。卫星地球俯冲 → 整条路线 3D 鸟瞰 → 镜头贴着人/车沿路线走(走过的线变黄、里程、海拔、累计爬升、小地图、底部海拔剖面、沿途弹照片)→…
git:20261009.683f73a · audit A · 77 stars
photo-spot SKILL.md skill
spacezephyr/map-motion · photo-spot/SKILL.md · 找机位 / 机位揭秘视频:给一张照片,做一段竖屏短片——卫星地球俯冲 → 落出拍照机位(相机图标)和被摄地点 → 取景扇形从机位扫向被摄地 → 取景框对焦 → 咔嚓快门声 → 照片从机位处翻折立起(3D 透视),背景是这张照片的虚化;可加…
git:20261009.8aa7a53 · audit A · 77 stars
travel-vlog SKILL.md skill
spacezephyr/map-motion · travel-vlog/SKILL.md · 旅行 vlog 地图视频:用户给一组旅行照片(和一张自己的照片),自动按照片 GPS 和拍摄时间找出机位、排好顺序、沿真实步行/驾车路线连起来;用照片生成用户的 Q…
git:20261009.683f73a · audit A · 77 stars

Every file in spacezephyr/map-motion

Browse by kind, by grade A, or by owner.