---

name: higgsfield-repurpose description: "Use when the user already has a FINISHED video and wants Higgsfield to repurpose, restyle, clip or analyze it: Shorts Studio (restyle one 4–120s source video into a set of short-form clips from a style preset), Clipify (turn one YouTube video into subtitled clips), Virality Predictor (predict virality, hook strength, attention, retention risk with a dashboard), or Video Analysis (scene-by-scene breakdown of an uploaded video or a YouTube link). Also use when the user asks which of these cost credits and which are free, 'turn my video into shorts', 'will this go viral', 'score my ad', 'break this video down scene by scene'. Names: shorts_studio_create, shorts_studio_create_preset, shorts_studio_list_presets, shorts_studio_status, clipify, virality_predictor, brain_activity, video_analysis_create, video_analysis_status." user-invocable: true metadata: tags: [higgsfield, repurpose, post-production, shorts-studio, clipify, virality-predictor, video-analysis, short-form, reels, youtube, analysis] version: 1.0.0 updated: 2026-09-26 parent: higgsfield

Higgsfield Repurpose — Shorts, Clips, and Analysis of Finished Video

QUICK FACTS

Routing aids — read the linked sections for the full rules. Nothing in this sub-skill is field-tested.

• Four surfaces take a video that already exists: Shorts Studio (restyle → shorts), Clipify (YouTube → subtitled clips), Virality Predictor (a score), Video Analysis (a scene breakdown) →
• Paid vs free is per tool — shorts_studio_create is PAID; its get_cost estimate and preset creation state they are free; list / status calls state no cost →
• Shorts Studio: source 4–120s, output 720p only, 9:16 default (16:9 optional); preflight with get_cost: true + duration_seconds — no preset or upload needed for the estimate →
• Shorts Studio presets store a STYLE (≤10 media, videos ≤30s, public https URLs) — write the preset prompt as laws, not adjectives →
• Clipify: exactly ONE YouTube URL per job; 1–20 clips; 9:16 / 1:1 / 16:9; subtitle font, case, position and highlight colour are parameters →
• Virality Predictor: input is a confirmed uploaded video or a completed generated video; it is a PREDICTION — compare variants with it, don't treat it as audience data →
• Video Analysis: exactly one of uploaded video / YouTube URL; ~3–5 min; warn up front: the longer the video, the less accurate the breakdown →
• Burned-in captions, cuts, soundtrack, voice swaps are other surfaces — hand-off map →

---

What this sub-skill is for

Every surface here starts from a video that already exists — a finished ad, a long YouTube video, a generated clip — and produces something derived from it: restyled shorts, cut-down clips, a performance prediction, or a scene list. None of them writes a generation prompt from scratch; that is the rest of this library.

Surface	Input	Output	Tool / model
Shorts Studio	One uploaded video, 4–120s + a style preset	A set of AI-restyled short-form clips	shorts_studio_* (MCP)
Clipify	One YouTube URL	Ready-to-share clips with subtitles	clipify (video catalog model)
Virality Predictor	An uploaded or generated video	Virality / engagement / attention / hook / retention-risk prediction + dashboard	virality_predictor (MCP)
Video Analysis	An uploaded video or a YouTube URL	Scene-by-scene analysis	video_analysis_* (MCP)

Not this sub-skill: changing what is inside a clip (swap an object, re-light, extend it) — that is ../higgsfield-seedance-2-5/SKILL.md (video_edit / video_extension), ../higgsfield-seedance-vfx/SKILL.md, or Genjutsu (../higgsfield-marketing-studio/SKILL.md § 14). Many edited versions of one ad → Ad Multiplier, same § 14.

---

Paid or free — read this before calling anything

[OFFICIAL — Higgsfield MCP tool schema, 2026-09-26] unless marked.

Tool	Spends credits?	Evidence
shorts_studio_create	PAID — "reserves credits"	Tool description
shorts_studio_create with get_cost: true + duration_seconds	Free — "estimate the credit cost without submitting a job"; no preset or source video needed	Tool description
shorts_studio_create_preset	Free — "just stores a STYLE — no generation, no credits"	Tool description
shorts_studio_list_presets · shorts_studio_list_sessions · shorts_studio_status	Not stated — list / status calls that submit nothing; not called free here	Tool descriptions (silent on cost)
clipify	Not stated. It is a video-catalog model, so it runs through generate_video / the CLI and can be preflighted with get_cost: true (MCP) or higgsfield generate cost clipify … (CLI — confirm the flag form with higgsfield model get clipify first)	[OFFICIAL — platform, 2026-09-26] snapshot has no price field
virality_predictor	Not stated, and the tool has no get_cost field	Tool schema
video_analysis_create	Not stated, and the tool has no get_cost field	Tool schema
video_analysis_status · video_analysis_jobs	Not stated — status / list calls that submit nothing; not called free here	Tool descriptions (silent on cost)

Where the schema is silent, do not call it free. Check the balance before and after (balance / transactions on MCP, higgsfield account status on the CLI) the first time a surface is used, and record what it actually cost. No prices appear in this file because none were measured.

---

Shorts Studio

[OFFICIAL — Higgsfield MCP tool schema, shorts_studio_*, 2026-09-26]

"Start a Shorts Studio short: restyle one uploaded source video (4s–120s) into a set of AI-generated short-form clips using a style preset. PAID — reserves credits."

Param	Values	Notes
source_video_id	uuid	The uploaded video's video_input id (media_upload_widget, type=video). Required unless get_cost
preset_id	uuid	From shorts_studio_list_presets or shorts_studio_create_preset. Required unless get_cost
preset_source	user · cms	The preset item's own preset_source. Required unless get_cost
aspect_ratio	9:16 (default) · 16:9	Output orientation
resolution	720p	The only value — the schema pins it as a constant
get_cost	bool	With duration_seconds, returns the estimate and submits nothing
duration_seconds	> 0, ≤ 120	Source length; required when get_cost is true

The run, in order:

1. Estimate first — get_cost: true + duration_seconds (free; no preset, no upload).
2. Pick or make a style — shorts_studio_list_presets returns the user's own presets first, then the CMS library (paginated via next_cursor); or make one (below).
3. Upload the source — the user uploads through media_upload_widget (type=video); the tool asks for an upload before it is called, never a chat attachment.
4. Create — PAID. Returns a session with empty job_ids.
5. Poll shorts_studio_status until clips appear. status='completed' means every clip job is terminal, not necessarily successful — check each clip.

Schema mismatch to know about: shorts_studio_status says to poll each clip's job_id "via job_status", but no job_status tool is in the connector's 2026-09-26 tool list — the listed job tools are jobs_wait, job_display and show_generation_by_ids. Which one the status tool means is unverified.

Not published: how many clips a session produces, how long each is, and what the restyle keeps from the source (timing, audio, framing). Look at one real session before promising any of them.

Style presets (free)

shorts_studio_create_preset stores a style from reference media — no generation, no credits.

• Limits: ≤ 10 media total; each video ≤ 30s (send duration so the cap applies); every media item a public https URL (use an uploaded media's URL, or media_import_url first).
• Fields: name (required), prompt (optional style direction), image_medias, video_medias, thumbnail.
• Naming: Higgsfield's own tool instruction is to give an unnamed preset a random friendly two-word name rather than ask — follow it.
• What this library adds [INFERENCE — untested]: a style preset is a saved style block, the same job as Cinema Studio's Manual Style — so write its prompt the same way: laws, not descriptions (grade behaviour, lighting law, texture, camera register), no vague labels, no director name-drops. See ../higgsfield-cinema/SKILL.md § Manual Style — Authoring Guide.

---

Clipify

[OFFICIAL — platform, 2026-09-26] — model clipify, "Turn one YouTube video into ready-to-share clips with subtitles" (video catalog, ../../specs/models_explore_snapshot_2026-09-26.json).

Param	Values	Default
urls	YouTube URL array — "Provide exactly one URL; submit one Clipify job per source video"	required
clips_num	1–20	10
clip_aspect	9:16 · 1:1 · 16:9	9:16
subtitle_font	notosans · notoserif · notosansdisplay · ibmplexsans · mplusrounded1c · bebasneue · archivoblack · unbounded · inter · montserrat · bangers · permanentmarker · playfairdisplay · caveat	notosans
subtitle_case	upper · lower · as-is	as-is
subtitle_position	bottom · center · top	bottom
subtitle_highlight_hex	#RRGGBB	#FFE84D
track_face_crop	bool — "Track faces when cropping clips"	true
max_height	144–2160 — "Maximum source processing height"	1080
segment_seconds	2–60 — "Segment duration in seconds"	10

Clipify vs Shorts Studio. Clipify cuts one YouTube video into subtitled clips; it has no style or restyle parameter. Shorts Studio restyles one uploaded video into AI-generated clips from a preset. Long talk / podcast / tutorial → clips: Clipify. A short piece whose look should change: Shorts Studio.

The source is fetched from YouTube — clip only videos the user owns or has the rights to. What segment_seconds controls beyond its one-line description is not documented.

---

Virality Predictor

[OFFICIAL — Higgsfield MCP tool schema, virality_predictor, 2026-09-26]

"predicts a video's virality potential, engagement, attention, audience response, retention risk, hook strength, and creative performance with an interactive dashboard."

• action: "create" with params.medias: [{role: "video", id: <uuid>}] — the id is a confirmed uploaded video media_id or a completed generated video job_id; params.model is the constant "virality_predictor".
• action: "preview" with params.job_id re-opens an existing dashboard.
• CLI face: Higgsfield's own skills repo says its Virality Predictor path "Uses Virality Predictor (brain_activity) with --video" [OFFICIAL — Higgsfield skills repo README, v0.12.0]; CLI 1.1.23 model get brain_activity shows a text-output model named "Brain Activity" that requires medias. That the two are the same product rests on that README line — not verified here.

How this library uses it [INFERENCE — untested]:

• It is a prediction, not audience data. This repo has never compared its scores with real performance. Report it as "the predictor says", never as "this will go viral".
• Compare variants, don't chase a number. The useful question is relative: hook A vs hook B on the same ad, cut 1 vs cut 2. Rewriting a creative only to move one score is optimizing the instrument.
• Natural pairings: hook variants from ../higgsfield-marketing-studio/SKILL.md, Ad Multiplier versions (same skill, § 14), campaign batches in ../higgsfield-content-factory/SKILL.md.

---

Video Analysis

[OFFICIAL — Higgsfield MCP tool schema, video_analysis_*, 2026-09-26]

• Input — exactly one of: video_input_id (an uploaded video's media id) or youtube_url (https on youtube.com, www.youtube.com, m.youtube.com or youtu.be only).
• Queued: returns status='queued'; poll video_analysis_status every 30–60 seconds until completed (scenes populated) or failed (fail_reason populated). "Processing typically takes 3-5 minutes on average." Past jobs: video_analysis_jobs.
• The warning the tool requires, verbatim: "warn the user up front that the longer the video, the less accurate the scene-by-scene analysis becomes — short clips give the most reliable results." Say it before submitting, every time.
• Practical consequence: trim to the sequence you actually care about before uploading.

Uses in this repo [HYPOTHESIS — UNMEASURED]:

• Reference breakdown — a short reference sequence → a scene list to seed ../higgsfield-shotlist-director/SKILL.md or to audit with ../higgsfield-scene-engine/SKILL.md. Analyze a reference for its structure; the shotlist still gets written, not copied.
• Cut check — did a generated multi-shot clip actually cut where the prompt declared ("strictly N shots")? The analysis is a second pair of eyes, not a verdict.
• The output's shape beyond "scenes" is not documented. Treat what comes back as notes to verify against the video, never as ground truth.

---

Where the neighbouring jobs live

The user wants	Surface	Where it is covered
Captions burned into the pixels	Higgsfield's subtitles workflow	../higgsfield-stack/SKILL.md § Higgsfield's bundled workflows
Cuts, trims, soundtrack, layouts, animated text, title cards on footage	Higgsfield's video-editing workflow (Higgsedit)	same
The same video at another aspect ratio	reframe (MCP tool; also a CLI workflow — verify params with higgsfield workflow get reframe --json)	—
A different voice on the same video	voice_change	../higgsfield-audio/SKILL.md § Voice change and voice cloning
One object swapped, or motion transferred	Genjutsu	../higgsfield-marketing-studio/SKILL.md § 14
Many independently edited versions of one ad	Ad Multiplier	same

---

Provenance

• Shorts Studio, Virality Predictor, Video Analysis: [OFFICIAL — Higgsfield MCP tool schema, 2026-09-26] — read from the connector's tool definitions; no tool was called.
• Clipify: [OFFICIAL — platform, 2026-09-26] — the video models_explore snapshot.
• brain_activity: CLI 1.1.23 model get (a free schema read) plus Higgsfield's skills repo README v0.12.0.
• Nothing here has been run; costs, clip counts, clip lengths and the accuracy of any analysis are unmeasured.

Related skills

• ../higgsfield-stack/SKILL.md — execution surfaces, preflight, Higgsfield's bundled workflows
• ../higgsfield-audio/SKILL.md — voice change and cloned voices
• ../higgsfield-marketing-studio/SKILL.md — ad creative, Ad Multiplier, Genjutsu
• ../higgsfield-content-factory/SKILL.md — campaign batches that virality scores can rank
• ../higgsfield-shotlist-director/SKILL.md · ../higgsfield-scene-engine/SKILL.md — where a scene breakdown goes next