# Rn Human Motion Extractor

Extract anonymized frame-by-frame body and hand trajectories from an authorized...

- Repository: https://github.com/Pluviobyte/rnskill (1706 stars)
- Category: Design
- License: see repository
- Last updated: 2026-09-21
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Pluviobyte/rnskill --skill rn-human-motion-extractor -g -a claude-code -y`
Codex: `npx skills add Pluviobyte/rnskill --skill rn-human-motion-extractor -g -a codex -y`
Cursor: `npx skills add Pluviobyte/rnskill --skill rn-human-motion-extractor -g -a cursor -y`
Gemini CLI: `npx skills add Pluviobyte/rnskill --skill rn-human-motion-extractor -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Pluviobyte/rnskill`

## Description

Extract anonymized frame-by-frame body and hand trajectories from an authorized reference video, with skeleton previews, confidence evidence, and machine-readable keypoints. Use when the user asks to 提取博主动作, 提取人体动作轨迹, 做姿态参考, 生成骨架视频, or prepare motion control data for an avatar; do not route graphic-animation replication here.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# RN Human Motion Extractor

Convert a selected range of an authorized reference video into reusable motion
data. Preserve motion and timing; do not package the source person's appearance,
voice, subtitles, or footage as a reusable identity asset.

## Boundary

- Use only a public or local reference the user is authorized to analyze.
- Keep source footage and identity-preserving overlay previews in the private
  project workspace. The pure-skeleton video and keypoint data are the portable
  motion assets.
- This Skill extracts evidence; it does not promise that a generative video
  model will obey every keypoint.
- Do not call a result "exact hand motion" when fingers are occluded, blurred,
  outside the frame, or below the confidence gate. Report coverage instead.
- Route designed cards, connectors, typography, and UI motion to
  `rn-motion-replica`; route full-frame replica claims to `rn-replica-qc`.

## Workflow

### 1. Lock the range and timebase

Confirm the input file and desired range. Probe the source with `ffprobe` and
record width, height, fps, duration, frame count, and audio presence. Default to
the full clip only when the range is already short and unambiguous.

### 2. Create a local runtime

The bundled extractor requires FFmpeg plus Python 3.10, 3.12. Use an isolated
environment; do not modify the system Python.

```bash
uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python -r \
  <skill-dir>/scripts/requirements.txt
```

### 3. Extract the trajectory

```bash
.venv/bin/python <skill-dir>/scripts/extract_motion.py \
  --input <reference.mp4> \
  --output <private-project-dir>/motion-extraction \
  --start 0 \
  --duration 10
```

Omit `--duration` to process from `--start` to the end. Use `--no-overlay` when
an identity-preserving QC preview is unnecessary.

The extractor records:

The rest: https://github.com/Pluviobyte/rnskill/blob/HEAD/skills/rn-human-motion-extractor/SKILL.md