keyframe-data-model

Name: keyframe-data-model
Availability: InStock
Author: imankha

Manage frame-based keyframes with origin tracking and interpolation rules.

Updated Nov 5, 2025

Search Tags:#interpolation #video-editing #crop #state-machine #keyframe #frame-based #origin-tracking

Ready to run

npx skills add https://github.com/imankha/video-editor --skill keyframe-data-model

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: keyframe-data-model
Source: https://github.com/imankha/video-editor/tree/main/src/frontend/.claude/skills/keyframe-data-model
Command: npx skills add https://github.com/imankha/video-editor --skill keyframe-data-model

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a frame-based keyframe data model and a lightweight state machine to manage crop and highlight animations, ensuring origin-correct edits and deterministic interpolation.

Core Features & Use Cases

Frame-based keyframes (not time-based) with explicit frame numbers
Origin tracking (permanent, user, trim) to support persistence and cleanup
A simple state machine for initialization, editing, and trimming
Interpolation and validation rules to maintain invariants across keyframes
Use in Framing and Overlay workflows to drive crop regions and highlight effects

Quick Start

Initialize the keyframe model, add keyframes via actions, and rely on the state machine to enforce invariants during editing.

Frequently Asked Questions about keyframe-data-model

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I manage frame-based keyframes for crop and highlight animations?▼

You manage frame-based keyframes by defining a frame-keyframe structure containing frame, origin, and data, which tracks precise edits and origins to support persistence and cleanup for crop and highlight animations.

What is the best way to track origins for keyframes during video editing?▼

The best way to track keyframe origins is using explicit origin tracking categories like permanent, user, and trim, which ensures origin-correct edits and supports deterministic interpolation across keyframes.

How do I ensure deterministic interpolation across keyframes in a framing workflow?▼

Deterministic interpolation is ensured by applying validation invariants and helper rules across your keyframes, maintaining consistent state machine transitions during initialization, editing, and trimming.

Can I use a state machine to enforce keyframe invariants during video editing?▼

Yes, you can use a lightweight state machine to enforce keyframe invariants during video editing, managing the lifecycle states of initialization, editing, and trimming to maintain deterministic interpolation.

How do I convert between frames and times for precise video edits?▼

You convert between frames and times using helper rules that translate frame-based keyframe data into time equivalents, ensuring frame-level edits align correctly with your video timeline.

When do I need a frame-based keyframe model instead of time-based for video edits?▼

You need a frame-based keyframe model when driving overlay or framing workflows that require explicit frame numbers for crop regions and highlight effects rather than continuous time-based values.