# Rn Replica Qc

Analyze, recreate, align, and verify reference-video motion.

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

## Install

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

## Description

Analyze, recreate, align, and verify reference-video motion. Use when the user asks to recreate, copy, match, align, pixel-align, or compare a video; when a HyperFrames or Remotion remake is judged not aligned; when fixed reference playback and reusable motion components must be separated; or when delivery needs full-frame runtime, render, decode, boundary, timing, and archive evidence instead of sampled screenshots alone.

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

# Reference Video Replica QC

## Role

Turn reference-video recreation into a red/green evidence loop and, when useful,
capture the aligned motion as reusable HyperFrames or Remotion components.

Read [replica-levels.md](references/replica-levels.md) before naming or promising
fidelity. A source-stream copy, an exact lossless render frame, an encoded
frame-aligned MP4, a visual rebuild, and a style reference are different claims.

## Canonical Showcase

- Human display name: Presenton 复刻 Bitexact 成片
- File: `assets/showcases/presenton-replica-pixel-aligned-bitexact.mp4`
- This showcase demonstrates source-stream bit exactness. Do not use it as proof
  that a hand-authored HTML composition is bit exact.

## Operating Modes

- **Analysis-only**: inspect and report; do not edit implementation code.
- **Replica-loop**: repair the candidate until the declared evidence gate passes.
- **Component-capture**: register a proven motion pattern with inputs and limits.

## Workflow

### 1. Declare The Contract

Record the reference, exact segment, renderer, fidelity label, deliverables,
component-library destination, and evidence required for approval. Use Goal mode
when available; otherwise keep `alignment-report.md` and `patch-log.md` beside
the project.

**Complete when:** the segment and every acceptance claim can be tested without
relying on chat memory.

### 2. Lock The Timebase

Probe FPS, duration, start time, pixel format, frame count, and audio presence.
For exact work, map timestamps to source frame numbers and extract by frame
index. Inclusive segment count is `(end_frame - start_frame) + 1`. When joining
adjacent inclusive segments, keep the earlier boundary frame and skip the first
frame of the next segment.

Use `extract_halfsec_frames.py` for discovery and `extract_frame_range.py` for
full-frame acceptance sequences.

**Complete when:** reference frame 1, final frame, count, and PTS mapping are
explicit and reproducible.

### 3. Choose The Architecture

The rest: https://github.com/Pluviobyte/rnskill/blob/HEAD/skills/rn-replica-qc/SKILL.md