Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

motion-graphics: point the Builder at hyperframes-creative's motion-principles.md

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,944 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@miguel-heygen đang làm issue này rồi.

Từ ngày 3/10/2026.

  • #4970 của @miguel-heygen — đã merge

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
88/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với skills/motion-graphics/agents/builder.md và skills/motion-graphics/SKILL.md để theo dõi ngữ cảnh dispatch của Builder, sau đó kiểm tra categories/charts/module.md và categories/stat/module.md. Xác minh rằng các tham chiếu đến motion-principles.md và data-in-motion.md đã được thêm vào các vị trí được yêu cầu, đồng thời tất cả liên kết đều trỏ đến các tệp hyperframes-creative hiện có.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement triage/needs-triage
Problem

skills/motion-graphics never references skills/hyperframes-creative (no mention in any file on main). As a result, hyperframes-creative/references/motion-principles.md is not on the motion-graphics read path, even though motion-graphics is the most motion-first workflow in the repo.

I checked whether its guardrails are covered elsewhere on that path (SKILL.md, agents/director.md, agents/builder.md, references/builder-contract.md, references/motion-vocabulary.md, plus the SKILL.md of hyperframes, hyperframes-core and hyperframes-animation). They mostly are not:

motion-principles.md guardrail Covered on the motion-graphics path?
Vary eases (≤2 tweens per scene with the same ease) No
.out for entrances, .in for exits, .inOut for moves No (only per-primitive examples in motion-vocabulary.md)
Vary duration (slowest scene ~3× the fastest) No
Vary entrance direction (not always y:30, opacity:0) No
Build / breathe / resolve scene structure Partly (categories/kinetic-type only: Hook → Build → Punch → Resolve)
Stagger by importance, total stagger < 500ms No
Exits faster than entrances No
Offset the first tween 0.1–0.3s No

The only route to the file today is indirect (hyperframes-animation/adapters/animate-text.md, or the capability table in hyperframes/SKILL.md), so whether the Builder reads it depends on the agent's own initiative.

hyperframes-creative/references/data-in-motion.md has the same gap for the charts and stat categories.

Proposed solution

A small docs-only change:

  1. skills/motion-graphics/agents/builder.md — add a line under "Critical correctness" (or a new "Motion quality" heading): read ../hyperframes-creative/references/motion-principles.md before writing the timeline.
  2. skills/motion-graphics/SKILL.md Step 4 — add that file to the Builder's dispatch context list.
  3. skills/motion-graphics/categories/charts/module.md and categories/stat/module.md — reference ../hyperframes-creative/references/data-in-motion.md.

Alternatives considered

Inlining a condensed version into references/motion-vocabulary.md. This avoids a cross-skill read but duplicates content that would drift from the original, so a link seems better.

Alternatives considered

Inlining a condensed version into references/motion-vocabulary.md. This avoids a cross-skill read but duplicates content that would drift from the original, so a link seems better.

Additional context

While building short HTML motion pieces with an AI coding assistant (outside HyperFrames), I hit exactly the failure modes this file warns about: uniform easing, missing exits, flat timing. That is what led me to compare the motion-graphics read path against motion-principles.md. I have not measured the effect inside the motion-graphics workflow itself.

Ngôn ngữ chính
TypeScript
Star
54.1k
Fork
4.9k
Merge trung bình
9 giờ 4 phút
Pull request đã merge (30 ngày)
662

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của heygen-com/hyperframes

Tất cả issue của heygen-com/hyperframes

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.