CommunityProgramación y desarrollogithub.com

saranambiar/hyperframes-video-agent-skills

Reusable skills, scripts, and production workflows for agent-led video creation with HyperFrames, FFmpeg, captions, audio sync, and render QA. Community project from real HyperFrames video work; not an official HyperFrames or HeyGen repository.

¿Qué es hyperframes-video-agent-skills?

hyperframes-video-agent-skills is a Cursor agent skill that reusable skills, scripts, and production workflows for agent-led video creation with HyperFrames, FFmpeg, captions, audio sync, and render QA. Community project from real HyperFrames video work; not an official HyperFrames or HeyGen repository.

Compatible con~Claude Code~Codex CLICursor
npx skills add saranambiar/hyperframes-video-agent-skills

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Product Demo Integration

Use this skill when product footage is part of the final video.

Intake

Before editing:

  • Probe recording duration, resolution, frame rate, and audio.
  • Identify whether the recording includes a canvas, browser frame, cursor, zooms, scrolls, or dead time.
  • Identify required product moments and their timestamps.
  • Identify narration phrases that must align with product states.
  • Ask for approval before aggressive crop if important UI may be cut off.

Crop Decision

Default to preserving UI over removing background canvas.

Use crop only when:

  • The important UI remains visible throughout zooms and scrolls.
  • The crop does not cut off headings, labels, cursor context, or final state.
  • A proof frame confirms the tightest zoom still works.

Use no-crop or light crop when:

  • The recording zooms into different areas.
  • The product moment moves around the canvas.
  • The user already says cropped output cut off key text.

Read references/crop-and-zoom.md for a checklist.

Transition Into Product Footage

  • Start from the previous scene final frame.
  • Use camera swipe or push motion rather than a hard cut if continuity is requested.
  • Land on the current first frame of the product recording.
  • If the recording starts with dead time, trim it only if doing so does not break sync.
  • If a product moment must align with narration, retime the segment before that moment rather than changing all later sync.

Transition Out

  • Preserve the last meaningful product state long enough for the viewer to register it.
  • Create a camera swipe to the next scene if requested.
  • Avoid accidental blank frames at the end of screen recordings.
  • Extract a proof frame at the transition boundary.

QA

  • Check first product frame.
  • Check every zoom peak.
  • Check every required product state.
  • Check transition in/out.
  • Confirm captions do not cover product UI.

Output

Return:

  • Source recording used.
  • Crop/no-crop decision.
  • Trim/retime segments.
  • Render path.
  • Proof frames for tightest crop and key product moments.

Product Moment Map

Create a moment map before editing:

  • Recording timestamp.
  • What is visible.
  • Narration phrase.
  • Desired global timestamp.
  • Whether cursor matters.
  • Whether scroll position matters.
  • Whether captions overlap.
  • Whether crop is safe.

Use this map to decide trims and retiming.

Crop Decision Matrix

Choose no crop when:

  • The user accepts canvas/background.
  • Zooms move across the screen.
  • Main text is cut by a tight crop.
  • The product state is more important than polish.

Choose light crop when:

  • Canvas is distracting but UI stays centered.
  • Captions need more room.
  • Browser chrome or dead margin can be removed safely.

Choose dynamic crop only when:

  • Each crop rectangle is mapped.
  • The movement feels intentional.
  • All key product states have proof frames.

Narration Sync

Sync product states to spoken phrases:

  • Start transition before the phrase if the product must be visible on the phrase.
  • Let final product frame hold after the phrase if comprehension matters.
  • Slow pre-moment footage rather than speeding a product scroll unnaturally.
  • Do not cut mid-word in narration to reach a product state.

Screen Recording Cleanup

Check:

  • Cursor visibility.
  • Browser UI.
  • Notification popups.
  • Dead time.
  • Blank loading screens.
  • Accidental desktop edges.
  • Scroll speed.
  • Zoom focus.

Only remove or hide these if it does not harm product clarity.

Caption Safety

If captions are burned in:

  • Check bottom nav bars.
  • Check product tables.
  • Check modal buttons.
  • Check timeline controls.
  • Move caption margin or choose a different proof frame if needed.

User Approval Points

Ask before:

  • Cropping out visible canvas.
  • Removing cursor.
  • Speeding footage dramatically.
  • Blurring or masking product details.
  • Replacing real footage with recreated UI.

Handoff Format

Report:

  • Product clip used.
  • Crop strategy.
  • Trim points.
  • Retime ratios.
  • Key proof frames.
  • Any UI that remains imperfect by design.

Skills relacionados