Communitygithub.com

Biznomad/agent-skills

安裝並配置 HyperFrames 組合中的註冊表區塊與元件。適用於執行 hyperframes add、安裝區塊或元件、將已安裝項目接入 index.html,或處理 hyperframes.json 時使用。涵蓋 add 指令、安裝位置、區塊子組合接線、元件片段合併,以及註冊表探索。

agent-skills 是什麼?

此技能專為 AI 代理(如 Claude Code、Cursor、Codex)設計,用以執行 HyperFrames 專案中的註冊表區塊與元件安裝及接線操作。它可協助代理識別何時需使用 `hyperframes add` 指令,並引導完成區塊(獨立子組合)與元件(無獨立尺寸的效果片段)的安裝流程。技能也支援將已安裝的項目接入現有組合,包含區塊的 `data-composition-src` 屬性設定,以及元件的 HTML、CSS、JS 片段合併。此外,它還提供註冊表探索功能,透過讀取註冊清單來尋找可用的區塊與元件。支援的平台包括 HyperFrames 框架及相關 CLI 工具。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/hyperframes-registry

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

HyperFrames 註冊表

註冊表提供可重複使用的區塊與元件,可透過 hyperframes add <名稱> 安裝。

  • 區塊 — 獨立的子組合(擁有自己的尺寸、持續時間、時間軸)。透過主組合中的 data-composition-src 引入。
  • 元件 — 效果片段(無獨立尺寸)。直接貼入主組合的 HTML 中。

何時使用此技能

  • 使用者提及 hyperframes add、「區塊」、「元件」或 hyperframes.json
  • 工作階段中出現 hyperframes add 的輸出結果(檔案路徑、剪貼簿片段)
  • 你需要將已安裝的項目接入現有組合
  • 你想探索註冊表中可用的項目

快速參考

hyperframes add data-chart              # 安裝一個區塊
hyperframes add grain-overlay           # 安裝一個元件
hyperframes add shimmer-sweep --dir .   # 指定目標專案
hyperframes add data-chart --json       # 機器可讀輸出
hyperframes add data-chart --no-clipboard  # 跳過剪貼簿(CI / 無頭模式)

安裝後,CLI 會印出寫入的檔案以及要貼入主組合的片段。該片段僅為起點 — 接線區塊時,你需額外加入 data-composition-id(必須與區塊內部的組合 ID 相符)、data-start 和 data-track-index 屬性。

注意:hyperframes add 僅適用於區塊與元件。如需範例,請改用 hyperframes init <目錄> --example <名稱>。

安裝位置

區塊預設安裝至 compositions/<名稱>.html。 元件預設安裝至 compositions/components/<名稱>.html。

這些路徑可在 hyperframes.json 中設定:

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

詳細資訊請參閱 install-locations.md。

接線區塊

區塊是獨立的組合 — 透過主 index.html 中的 data-composition-src 引入:

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

關鍵屬性:

  • data-composition-src — 區塊 HTML 檔案路徑
  • data-composition-id — 必須與區塊的內部 ID 相符
  • data-start — 區塊在主時間軸中出現的時間(秒)
  • data-duration — 區塊播放時長
  • data-width / data-height — 區塊畫布尺寸
  • data-track-index — 圖層順序(數字越大越靠前)

詳細資訊請參閱 wiring-blocks.md。

接線元件

元件是片段 — 將其 HTML 貼入組合的標記中,CSS 貼入樣式區塊,JS 貼入腳本(若有的話):

  1. 讀取已安裝的檔案(例如 compositions/components/grain-overlay.html)
  2. 將 HTML 元素複製到組合的 <div data-composition-id="..."> 中
  3. 將 <style> 區塊複製到組合的樣式中
  4. 將任何 <script> 內容複製到組合的腳本中(時間軸程式碼之前)
  5. 若元件暴露了 GSAP 時間軸整合(請參閱片段中的註解區塊),將那些呼叫加入你的時間軸

詳細資訊請參閱 wiring-components.md。

探索

瀏覽可用的項目:

# 讀取註冊清單
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

每個項目的 registry-item.json 包含:名稱、類型、標題、描述、標籤、尺寸(僅區塊)、持續時間(僅區塊)以及檔案列表。

依照類型和標籤篩選的詳細資訊請參閱 discovery.md。

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-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.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

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

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

相關技能