recut-reference

Analyze reference media and write structured understanding back to asset content and attributes.

38|4|Updated Jul 29, 2026
One-click install
npx skills add https://github.com/6174/recut --skill recut-reference-6174
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: recut-reference
Source: https://github.com/6174/recut/tree/main/service/skills/recut-reference
Command: npx skills add https://github.com/6174/recut --skill recut-reference-6174

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yt-dlp, ffmpeg, ffprobe, PySceneDetect, and includes references (resource) components.

What problem does it solve? Creators who want to learn from a proven video often rewatch it repeatedly without capturing reusable insights. This Skill reads a reference video, audio, image, or webpage and writes the understanding—hook, format, beats, visual/audio systems, and transferable criteria—directly onto the asset's content and attributes so it can be reused across projects. ## Core Features & Use Cases - Media Import & Probing: Import local files, direct media URLs, or webpage links via recut.media.import, then inspect duration, dimensions, frame rate, and audio tracks with probe. - Frame-Level Reading: Use contact sheets with timecodes (optionally overlaid with transcript words) and individual frames to read pacing, hooks, and visual systems in detail. - Structured Write-Back: Store whole-video understanding in asset content with inline media references, and machine-readable criteria in ref.* attributes (summary, format, hook, beats, systems, transferable). - Use Case: You find a viral product video on YouTube. Download it with yt-dlp, import it, and let the Skill produce a beat-by-beat breakdown with source timestamps and a transferable-vs-not-copyable analysis that a director skill can later use to plan your own version. ## Quick Start Import this reference video with recut.media.import, mark it as role reference, then analyze its hook, beats, and visual systems and write the understanding back to the asset's content and ref.* attributes.

Frequently Asked Questions about recut-reference

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

FAQPage Schema
How do I analyze a reference video with an AI agent?▼

Import the video with recut.media.import, mark it with the reference role attribute, then read it using probe, contactSheet, and frames. The understanding is written back to the asset's content field and ref.* attributes such as ref.hook, ref.beats, and ref.transferable.

How to download YouTube or Douyin videos for reference analysis?▼

Use yt-dlp with browser cookies to probe and download the video to your workspace, then import the file with recut.media.import. Platform pages are not downloaded directly; only files imported into the media library count as completed.

Does reference video analysis require a vision-capable model?▼

Yes. Understanding a reference video requires a model that can read images. If the current model lacks vision, the Skill stops immediately and asks you to switch models rather than substituting transcripts or cut points for actual frame reading.

What attributes does the reference analysis write to an asset?▼

It writes controlled ref.* attributes: ref.summary, ref.format, ref.hook, ref.beats, ref.systems, and ref.transferable, plus role and url for provenance. Long-form understanding with timestamped details goes into the asset's content field with inline media references.

Why does frame extraction fail or return zero frames?▼

Zero frames usually means the requested interval exceeds the video duration, so run probe first to get the real length. Other causes include missing ffmpeg or PySceneDetect dependencies, which must be prepared through understand.prepare rather than manual installation.

What are the limitations of reference understanding in Recut?▼

The Skill only reads and records understanding; it does not decide what to replace in a remake, which belongs to the director skill, nor does it execute the clone. Analysis artifacts stay workspace-level and are never attached to projects.