Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

新しいHyperFramesレジストリブロック(キャプションスタイル、VFXブロック、トランジション、ローワーサード)またはコンポーネント(テキストエフェクト、オーバーレイ、スニペット)を作成し、上流のhyperframesリポジトリにPRとして送信します。ユーザーが公開カタログにコントリビュートしたい場合にのみ使用します。プロジェクト内でのキャプション/トランジション作成には`hyperframes`スキルを、既存のレジストリアイテムのインストールには`hyperframes-registry`スキルを使用してください。

Tony-Claude-Code-Skills とは?

このスキルは、HyperFramesレジストリに新しいブロックまたはコンポーネントをコントリビュートするための完全なワークフローを提供します。ブロック(固定サイズ・固定長の独立した合成)とコンポーネント(サイズ不定の再利用可能なスニペット)の2種類のアイテムをサポートし、アイデアの明確化からスキャフォールディング、ビルド、バリデーション、プレビュー、そしてPRによる出荷までを段階的にガイドします。GSAPアニメーションのベストプラクティス(フォントサイズ、オーバーフロー処理、カラオケ効果など)、Three.jsベースのVFXブロック、ユニークなID命名規則、`hyperframes lint`や`validate`コマンドを使った品質ゲート、カタログプレビュー画像の生成方法など、実装に必要な詳細なテクニカルルールを網羅しています。最後にGitHubでのブランチ作成、フォーマット、コミット、PR作成までの手順を自動化し、外部コントリビューター向けの代替フローもカバーしています。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-contribute-catalog

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

HyperFramesレジストリへのコントリビュート

新しいレジストリブロックまたはコンポーネントについて、アイデアからマージされたPRまでユーザーを導きます。

ワークフロー

1. 明確化 → 2. スキャフォールディング → 3. ビルド → 4. バリデーション → 5. プレビュー → 6. 出荷

ステップ 1: 明確化

何を作成するのか尋ねます。レジストリには2種類のアイテムがあります。

  • ブロック(registry/blocks/、タイプhyperframes:block) — 固定の寸法と再生時間を持つ完全な独立した合成。キャプションスタイル、VFXエフェクト、タイトルカード、ローワーサード。
  • コンポーネント(registry/components/、タイプhyperframes:component) — 固定の寸法や再生時間がない再利用可能なスニペット。CSSエフェクト、テキスト処理、任意の合成サイズに適応するオーバーレイ。

次に以下を尋ねます。

  • エフェクトの一文による説明
  • ビジュアルリファレンス(URL、スクリーンショット、または説明)
  • 誰がいつ使うのか?

ステップ 2: スキャフォールディング

レジストリ構造を作成します。

ブロックの場合:

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

コンポーネントの場合:

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

命名規則:

アイテム名IDプレフィックスIDの例
cap-hormozihzhz-cg-0, hz-cw-3
cap-typewritertwtw-cg-0, tw-ch-0-5
vfx-chromevcvc-canvas

2~3文字のプレフィックスを使用します。サブコンポジション内での衝突を避けるため、すべての要素IDにこのプレフィックスを使用する必要があります。

ブロック用のregistry-item.json:

{
  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
  "name": "{block-name}",
  "type": "hyperframes:block",
  "title": "{人間が読めるタイトル}",
  "description": "{一文の説明}",
  "dimensions": { "width": 1920, "height": 1080 }, // 縦長/ソーシャル用は1080x1920に調整
  "duration": 10, // コンポジションに合わせて調整
  "tags": ["{カテゴリ}", "{サブカテゴリ}"],
  "files": [
    {
      "path": "{block-name}.html",
      "target": "compositions/{block-name}.html",
      "type": "hyperframes:composition"
    }
  ]
}

コンポーネント用のregistry-item.json(dimensionsやdurationはなし):

{
  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
  "name": "{component-name}",
  "type": "hyperframes:component",
  "title": "{人間が読めるタイトル}",
  "description": "{一文の説明}",
  "tags": ["{カテゴリ}"],
  "files": [
    {
      "path": "{component-name}.html",
      "target": "compositions/components/{component-name}.html",
      "type": "hyperframes:snippet"
    }
  ]
}

ステップ 3: ビルド

タイプに応じて正しいテンプレートを適用します。コピーペースト用のスターターについてはtemplates.mdを参照してください。

キャプションブロック

絶対に守るべきキャプションのルール:

  • フォント: プロポーショナルフォントは最小96px。等幅フォントは64~72pxで許容(文字幅が広いためサイズは小さくて済む)。
  • 可読性: -webkit-text-stroke: 2-3px または多層 text-shadow
  • オーバーフロー: すべてのグループで window.__hyperframes.fitTextFontSize() を呼び出す
  • カラオケ: tl.to(wordEl, { color/scale }, WORDS[wi].start) でアクティブな単語をハイライト
  • ハードキル: すべてのグループに対して tl.set(groupEl, { opacity: 0, visibility: "hidden" }, g.end)
  • tl.from(el, { opacity: 0 }) を tl.set(el, { opacity: 1 }) と同じ位置で使用しないこと — fromはsetを上書きします。代わりに tl.to を使用してください。

文字ごとのアニメーション(タイプライター、スクランブル):

  • 各文字をID {prefix}-ch-{group}-{char} の <span> でラップ
  • 単語のタイムスタンプから計算した間隔で tl.set を使ってスタッガー
  • カーソル/装飾要素: 間隔を空けて tl.set を使用 — CSSアニメーションは使用しない(シーク不可のため)

位置バリエーション:

  • 中央揃え: display: flex; align-items: center; justify-content: center;
  • ローワーサード: position: absolute; bottom: 100px; left: 0; width: 100%; text-align: center;
  • 左揃え: position: absolute; bottom: 100px; left: 120px; text-align: left;

VFXブロック(Three.js)

  • CDNから [email protected] を使用(グローバルスクリプト)
  • tl.eventCallback("onUpdate", renderScene); renderScene(); — requestAnimationFrame は使用しない
  • ステートプロキシパターン: GSAPはプレーンなJavaScriptオブジェクトをアニメーションし、レンダリング関数がそれを読み取る
  • シード付きPRNG(mulberry32)でランダム性を確保

すべてのタイプ共通

  • data-composition-id は window.__timelines["id"] と一致させる必要がある
  • すべての要素IDはブロック略語をプレフィックスとする
  • gsap.timeline({ paused: true }) — 常に一時停止状態
  • Math.random()、Date.now() は使用しない

ステップ 4: バリデーション

hyperframes lint                    # エラー0必須
hyperframes validate --no-contrast  # コンソールエラー0必須

ステップ 5: プレビュー

# プレビュー動画をレンダリング
hyperframes render -o preview.mp4

# ビジュアルQA用のスナップショット
hyperframes snapshot --at "1.0,3.0,5.0,7.0"

# レビュー用に hyperframes.dev に公開
npx hyperframes publish

カタログプレビュー画像 — カタログカードは docs/images/catalog/{kind}/{name}.png のPNG画像を使用します({kind} は blocks または components)。スナップショットから生成してください。その後:

  • HeyGen社内コントリビューター: scripts/upload-docs-images.sh を実行(AWSプロファイル engineering-767398024897 が必要)
  • 外部コントリビューター: プレビューMP4をPRの説明に添付してください。メンテナーがマージ前にカタログ画像を生成してアップロードします。

ステップ 6: 出荷

すべてのステップが必須です。1つでも欠けると、カタログエントリが壊れます。

{kind} はステップ1で作成したものに応じて blocks または components です。

# 1. ブランチを作成
git checkout -b feat/registry-{name}

# 2. HTMLをフォーマット
npx oxfmt registry/{kind}/{name}/*.html

# 3. registry/registry.json を更新 — "items"配列にエントリを追加:
#    { "name": "{name}", "type": "hyperframes:block" } (または "hyperframes:component")

# 4. カタログドキュメントページを生成
npx tsx scripts/generate-catalog-pages.ts

# 5. レビューアーがプレビューできるように hyperframes.dev に公開
npx hyperframes publish

# 6. すべてをステージング
git add registry/{kind}/{name}/ registry/registry.json docs/catalog/

# 7. コミット
git commit -m "feat(registry): add {name} — {一文の説明}"

# 8. プッシュし、hyperframes.dev リンクを付けてPRを開く
git push origin feat/registry-{name}
gh pr create --title "feat(registry): {name}" --body "preview: {hyperframes.dev-url}"

GitHubアカウントをお持ちでない場合: PRを開くにはアカウントが必要です。https://github.com/signup でサインアップし、gh auth login を実行してください。

品質ゲート

  • hyperframes lint → エラー0
  • hyperframes validate → コンソールエラー0
  • npx oxfmt --check がパスする
  • registry/registry.json が新しいエントリで更新されている
  • scripts/generate-catalog-pages.ts が実行されている(ドキュメントページが生成されている)
  • npx hyperframes publish が実行されている(プロジェクトURLを主張する)
  • プレビューMP4がPRに添付されている(外部)またはカタログPNGがアップロードされている(内部)
  • すべてのIDが一意であり、プレフィックスが付いている

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

shengdabai/Tony-Claude-Code-Skills

Read-only queue dashboard for workspace-aware ship. (gstack)

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-Skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

shengdabai/Tony-Claude-Code-Skills

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

shengdabai/Tony-Claude-Code-Skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

shengdabai/Tony-Claude-Code-Skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

関連スキル