contribute-catalog

Guides authoring and shipping HyperFrames registry blocks and components as upstream pull requests.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/gmolike/Claude-Template --skill contribute-catalog-gmolike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: contribute-catalog
Source: https://github.com/gmolike/Claude-Template/tree/main/.agents/skills/contribute-catalog
Command: npx skills add https://github.com/gmolike/Claude-Template --skill contribute-catalog-gmolike

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Contributing a new caption style, VFX block, transition, or component to the HyperFrames public registry involves strict conventions (ID prefixes, GSAP timeline rules, registry-item.json schema, catalog docs generation) that are easy to get wrong, producing broken catalog entries or rejected PRs. ## Core Features & Use Cases - End-to-end contribution workflow: Walks through six stages — clarify, scaffold, build, validate, preview, ship — for both registry blocks (fixed-dimension compositions) and components (reusable snippets). - Copy-paste templates: Provides proven caption, Three.js VFX, and component HTML templates plus registry-item.json schemas that pass lint and validation. - Quality gate enforcement: Requires hyperframes lint, validate, oxfmt formatting, registry.json updates, catalog page generation, and preview publishing before opening the PR. - Use Case: A developer wants to add a new karaoke caption style to the public HyperFrames catalog; the skill scaffolds registry/blocks/cap-swoosh/, applies the caption template with correct ID prefixes, validates it, and produces a ready-to-review PR with a hyperframes.dev preview link. ## Quick Start Ask the assistant to help you contribute a new caption style or VFX block to the HyperFrames registry catalog and follow the guided workflow.

Frequently Asked Questions about contribute-catalog

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

FAQPage Schema
How do I contribute a new caption style to the HyperFrames registry?

Scaffold a block under registry/blocks/ with an HTML composition and registry-item.json, build it using the caption template with prefixed element IDs, then run hyperframes lint and validate. Finally update registry.json, generate catalog docs, publish a preview, and open a PR.

What is the difference between a HyperFrames block and a component?

A block is a standalone composition with fixed dimensions and duration, such as caption styles or lower thirds. A component is a reusable snippet without fixed dimensions, like text effects or overlays, that adapts to any parent composition.

Why does my HyperFrames caption animation fail validation?

Common causes include using tl.from with opacity 0 at the same position as tl.set opacity 1, missing the hard-kill tl.set that hides each group at its end time, or using Math.random or Date.now instead of a seeded PRNG.

Can I use requestAnimationFrame in a Three.js VFX block?

No. VFX blocks must render via tl.eventCallback("onUpdate", renderScene) so frames stay seekable with the GSAP timeline. Use [email protected] from CDN and a state proxy object that GSAP animates while the render function reads it.

When should I use the hyperframes skill instead of contribute-catalog?

Use contribute-catalog only when shipping a new item to the public upstream registry as a PR. For authoring captions or transitions inside your own project, use the hyperframes skill; for installing existing registry items, use hyperframes-registry.