contribute-catalog

The contribute-catalog skill helps developers and motion designers create and contribute new items to the public HyperFrames registry. It provides a guided workflow for authoring registry blocks and reusable components, organizing the required project structure, and preparing contributions for upstream pull requests. The skill is specifically intended for public catalog contributions rather than private project authoring or installation workflows. It supports contributors from the initial idea phase through scaffolding, implementation, validation, previewing, and final submission.

The skill distinguishes between two registry item types: standalone blocks and reusable components. Blocks are complete compositions with fixed dimensions and durations, commonly used for caption styles, VFX effects, title cards, and lower thirds. Components are adaptable snippets intended for reuse across compositions, such as overlays, CSS effects, and text treatments. The workflow includes guidance for directory structure creation, naming conventions, registry metadata configuration, and element ID prefixing to avoid collisions. It also includes implementation guidance for caption animations, typography sizing, readability standards, overflow handling, karaoke-style highlighting, per-character animations, and animation timing best practices.

This skill is designed for contributors who want to expand the HyperFrames ecosystem with reusable creative assets. It is especially useful for frontend developers, motion graphics creators, UI animators, and open-source contributors building caption systems, transitions, VFX compositions, and reusable animation snippets. Teams maintaining branded motion libraries or creators contributing community effects to the HyperFrames registry can use this workflow to ensure consistency, compatibility, and submission readiness.