К основному содержанию
скилл CX Codex

contribute-catalog — скилл для Claude Code: что делает и установка

Скилл contribute-catalog для Claude Code и Codex ведёт создание блока или компонента HyperFrames от идеи до PR в публичный каталог. Задачи: caption styles, VFX, переходы и lower thirds.

Apache-2.0 211 установок ★ 484 обновлён 2026-08-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add boraoztunc/skills --skill contribute-catalog -a claude-code
Открыть на GitHub

Что делает contribute-catalog

contribute-catalog помогает пройти путь от идеи до PR для нового элемента HyperFrames. Он различает самостоятельные блоки в registry/blocks/ и переиспользуемые компоненты в registry/components/, создаёт нужную структуру файлов и подсказывает формат registry-item.json.

Скилл ведёт сборку, проверку и предпросмотр через hyperframes lint, hyperframes validate, hyperframes render, hyperframes snapshot и npx hyperframes publish. Для отправки изменений он подсказывает создание ветки, форматирование HTML, обновление каталога, коммит и открытие PR. Без GitHub-аккаунта открыть PR нельзя.

Какие задачи решает

  • создать блок HyperFrames для caption style или lower third
  • собрать переиспользуемый компонент с текстовым эффектом или overlay
  • проверить HTML и консольные ошибки перед публикацией
  • подготовить превью нового элемента каталога
  • отправить изменение в upstream-репозиторий через PR

Примеры запросов агенту

  • Создай новый блок HyperFrames для lower third и подготовь его к PR в публичный каталог.
  • Собери компонент с текстовым эффектом, проверь его через hyperframes lint и покажи превью.
  • Проведи меня от идеи нового перехода до публикации PR в репозиторий HyperFrames.

Как установить contribute-catalog

1Через Skills CLI (Vercel)

npx skills add boraoztunc/skills --skill contribute-catalog -a claude-code

2Вручную: положить файлы

~/.claude/skills/contribute-catalog/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/contribute-catalog/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о contribute-catalog

Как установить contribute-catalog в Claude Code?

Выполните npx skills add boraoztunc/skills --skill contribute-catalog -a claude-code. Файл скилла появится по пути ~/.claude/skills/contribute-catalog/SKILL.md.

Что делает contribute-catalog?

Он помогает создать новый блок или компонент HyperFrames, проверить его, подготовить превью и отправить в публичный каталог через upstream PR.

Чем блок отличается от компонента в HyperFrames?

Блок — самостоятельная композиция с фиксированными размерами и длительностью. Компонент — переиспользуемый фрагмент без фиксированных размеров и длительности.

Исходный текст

SKILL.md · Apache-2.0
---
name: contribute-catalog
description: Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.
---

# Contribute to HyperFrames Registry

Guide the user from idea to merged PR for a new registry block or component.

## Workflow

```
1. Clarify → 2. Scaffold → 3. Build → 4. Validate → 5. Preview → 6. Ship
```

### Step 1: Clarify

Ask what they're building. The registry has two item types:

- **Block** (`registry/blocks/`, type `hyperframes:block`) — a full standalone composition with fixed dimensions and duration. Caption styles, VFX effects, title cards, lower thirds.
- **Component** (`registry/components/`, type `hyperframes:component`) — a reusable snippet with no fixed dimensions or duration. CSS effects, text treatments, overlays that adapt to any composition size.

Then ask:

- One-sentence description of the effect
- Visual reference (URL, screenshot, or description)
- Who uses this and when?

### Step 2: Scaffold

Create the registry structure:

**For blocks:**

```
registry/blocks/{block-name}/
  {block-name}.html
  registry-item.json
```

**For components:**

```
registry/components/{component-name}/
  {component-name}.html
  registry-item.json
```

**Naming convention:**

| Item name        | ID prefix | Example IDs            |
| ---------------- | --------- | ---------------------- |
| `cap-hormozi`    | `hz`      | `hz-cg-0`, `hz-cw-3`   |
| `cap-typewriter` | `tw`      | `tw-cg-0`, `tw-ch-0-5` |
| `vfx-chrome`     | `vc`      | `vc-canvas`            |

Use a 2-3 letter prefix. ALL element IDs must use this prefix to avoid collisions in sub-compositions.

**registry-item.json for blocks:**

```json
{
  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
  "name": "{block-name}",
  "type": "hyperframes:block",
  "title": "{Human Title}",
  "description": "{one sentence}",
  "dimensions": { "width": 1920, "height": 1080 }, // adjust: 1080x1920 for portrait/social
  "duration": 10, // adjust for your composition
  "tags": ["{category}", "{subcategory}"],
  "files": [
    {
      "path": "{block-name}.html",
      "target": "compositions/{block-name}.html",
      "type": "hyperframes:composition"
    }
  ]
}
```

**registry-item.json for components** (no `dimensions` or `duration`):

```json
{
  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
  "name": "{component-name}",
  "type": "hyperframes:component",
  "title": "{Human Title}",
  "description": "{one sentence}",
  "tags": ["{category}"],
  "files": [
    {
      "path": "{component-name}.html",
      "target": "compositions/components/{component-name}.html",
      "type": "hyperframes:snippet"
    }
  ]
}
```

### Step 3: Build

Apply the correct template based on type. See [templates.md](templates.md) for copy-paste starters.

#### Caption blocks

**Non-negotiable caption rules:**

- Font: **96px minimum** for proportional fonts. **64-72px acceptable for monospace** (wider characters need less size).
- Readability: `-webkit-text-stroke: 2-3px` OR multi-layer `text-shadow`
- Overflow: call `window.__hyperframes.fitTextFontSize()` on every group
- Karaoke: highlight active word via `tl.to(wordEl, { color/scale }, WORDS[wi].start)`
- Hard kill: `tl.set(groupEl, { opacity: 0, visibility: "hidden" }, g.end)` on EVERY group
- **Never use `tl.from(el, { opacity: 0 })` at the same position as `tl.set(el, { opacity: 1 })`** — the from clobbers the set. Use `tl.to` instead.

**Per-character animation** (typewriter, scramble):

- Wrap each character in `<span>` with ID `{prefix}-ch-{group}-{char}`
- Stagger via `tl.set` at computed intervals from word timestamps
- Cursors/decorative elements: use `tl.set` at intervals — NOT CSS animation (not seekable)

**Positioning variants:**

- Centered: `display: flex; align-items: center; justify-content: center;`
- Lower-third: `position: absolute; bottom: 100px; left: 0; width: 100%; text-align: center;`
- Left-aligned: `position: absolute; bottom: 100px; left: 120px; text-align: left;`

#### VFX blocks (Three.js)

- Use `[email protected]` from CDN (global script)
- `tl.eventCallback("onUpdate", renderScene); renderScene();` — NO requestAnimationFrame
- State proxy pattern: GSAP animates plain JS object, render function reads it
- Seeded PRNG (`mulberry32`) for randomness

#### All types

- `data-composition-id` MUST match `window.__timelines["id"]`
- All element IDs prefixed with block abbreviation
- `gsap.timeline({ paused: true })` — always paused
- No `Math.random()`, no `Date.now()`

### Step 4: Validate

```bash
hyperframes lint                    # 0 errors required
hyperframes validate --no-contrast  # 0 console errors required
```

### Step 5: Preview

```bash
# Render preview video
hyperframes render -o preview.mp4

# Snapshot for visual QA
hyperframes snapshot --at "1.0,3.0,5.0,7.0"

# Publish to hyperframes.dev for review
npx hyperframes publish
```

**Catalog preview image** — The catalog card uses a PNG at `docs/images/catalog/{kind}/{name}.png` (where `{kind}` is `blocks` or `components`). Generate it from a snapshot, then:

- **HeyGen internal contributors:** run `scripts/upload-docs-images.sh` (requires AWS profile `engineering-767398024897`)
- **External contributors:** attach the preview MP4 to your PR description. A maintainer will generate and upload the catalog image before merging.

### Step 6: Ship

**All steps are required. Missing any one produces a broken catalog entry.**

`{kind}` is `blocks` or `components` depending on what you built in Step 1.

```bash
# 1. Create branch
git checkout -b feat/registry-{name}

# 2. Format HTML
npx oxfmt registry/{kind}/{name}/*.html

# 3. Update registry/registry.json — add entry to the "items" array:
#    { "name": "{name}", "type": "hyperframes:block" }  (or "hyperframes:component")

# 4. Generate catalog docs page
npx tsx scripts/generate-catalog-pages.ts

# 5. Publish to hyperframes.dev so reviewers can preview
npx hyperframes publish

# 6. Stage everything
git add registry/{kind}/{name}/ registry/registry.json docs/catalog/

# 7. Commit
git commit -m "feat(registry): add {name} — {one sentence}"

# 8. Push and open PR with hyperframes.dev link
git push origin feat/registry-{name}
gh pr create --title "feat(registry): {name}" --body "preview: {hyperframes.dev-url}"
```

**If you don't have a GitHub account:** you need one to open a PR. Sign up at https://github.com/signup, then run `gh auth login`.

## Quality Gate

- [ ] `hyperframes lint` → 0 errors
- [ ] `hyperframes validate` → 0 console errors
- [ ] `npx oxfmt --check` passes
- [ ] `registry/registry.json` updated with new entry
- [ ] `scripts/generate-catalog-pages.ts` run (docs page generated)
- [ ] `npx hyperframes publish` run (claim your project URL)
- [ ] Preview MP4 attached to PR (external) or catalog PNG uploaded (internal)
- [ ] All IDs unique and prefixed

© boraoztunc · Apache-2.0 · boraoztunc/skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
hyperframes-registry heygen-com Скилл hyperframes-registry ищет и добавляет редактируемые HyperFrames-блоки для переходов, титров, субтитров, графиков и 3D-сцен. Поиск запускается перед ручной сборкой визуального эффекта. CX Codex +1 1 400 000установок od-contribute nexu-io Скилл od-contribute для Claude Code помогает отправить вклад в OpenDesign: скилл, дизайн-систему, перевод документации, правку текста или сообщение об ошибке. Агент проверяет материалы и открывает PR либо issue. CX Codex +1 2 000установок launch-video charlie947 Скилл launch-video собирает промо-ролики для запуска продуктов на 30–45 секунд в виде автономного HTML-файла с покадровой анимацией и экспортом в MP4. Пригодится при релизе SaaS или курса. CX Codex +1 3 400установок 8-bit-orbit-video-template nexu-io Скилл 8-bit-orbit-video-template задаёт шаблон ретро-видео в стиле 8-bit для Hyperframes. Он пригодится, когда нужно собрать HTML-композицию из нескольких сцен с переходами и предпросмотром. CX Codex +1 3 100установок hyperframes heygen-com Скилл hyperframes для Claude Code рендерит видео на основе HTML через покадровый обход временной шкалы. CX Codex +1 1 600 000установок hyperframes-video-composition calesthio Скилл hyperframes-video-composition для Claude Code задаёт пайплайн сборки видео из HTML, CSS и медиа через HyperFrames. Помогает планировать сцены, сетку кадров, аудиодорожки и проверки доступности. CX Codex +1 161установок

Из того же набора22

Весь набор →
tailwind Скилл настраивает Tailwind CSS v4.2 для HyperFrames-композиций и помогает отлаживать стили перед захватом кадров. CX Codex +1 218установок hyperframes-cli Скилл hyperframes-cli оркестрирует создание HTML-видео через npx hyperframes: от инициализации проекта до визуального аудита и сборки MP4. CX Codex +1 216установок lottie Учит агента встраивать анимации Lottie и dotLottie в HyperFrames так, чтобы таймлайн можно было перемотать на любой кадр. CX Codex +1 212установок waapi Скилл waapi помогает настроить анимации через Web Animations API для детерминированного рендера в HyperFrames без использования сторонних библиотек вроде GSAP. CX Codex +1 211установок three Держит Three.js-сцену в HyperFrames синхронной со временем ролика: адаптер шлёт hf-seek, а сцена рисует запрошенный кадр. CX Codex +1 209установок typegpu Скилл для создания GPU-композиций с TypeGPU и WebGPU в HyperFrames: фрагментные шейдеры WGSL, вычислительные пайплайны, стеклянные эффекты и частицы на canvas. CX Codex +1 207установок linear-local-first-architecture Скилл linear-local-first-architecture задаёт агенту архитектуру веб-приложения, которое реагирует мгновенно: данные живут в IndexedDB, правки применяются локально, синхронизация идёт фоном. CX Codex +1 201установок conductor-rewrite-performance Скилл conductor-rewrite-performance для Claude Code оптимизирует React-интерфейсы локальных десктопных приложений на Tauri, устраняя каскадные перерендеры и задержки при стриминге сообщений. CX Codex +1 186установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой