Install
$ agentstack add skill-calesthio-generative-media-skills-editing-montage ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Editing and montage direction
Use this skill when the edit itself determines whether a video works. Your job is to make decisions about sequence, duration, shot function, rhythm, continuity, audio/visual relationship, platform fit, and revision logic. Do not treat editing as "put the clips in order." Treat it as the craft of controlling what the viewer notices, understands, feels, and remembers.
Work provider-independently. The source clips may be human-shot footage, generated clips, stills animated in a composition engine, screen recordings, avatar footage, stock, captions, product UI, diagrams, or music. The same edit principles apply, but generated media needs stricter provenance, continuity, and QA because shots may not share stable identity, lighting, geometry, text, or physics.
Evidence classes to keep separate
Documented facts:
- Film-analysis sources commonly describe editing as the relationship between shots and the construction of graphic, rhythmic, spatial, and temporal relationships. Source: Yale Film Analysis, "Part 4: Editing" ().
- J-cuts introduce the next shot or scene's audio before the visual cut; L-cuts let prior audio continue after the visual cut. Source: DINFOS Pavilion, "How to Edit Video with the J-Cut and L-Cut," last verified 2025-01-16 ().
- Prerecorded synchronized media with audio needs captions under WCAG 2.2 Success Criterion 1.2.2 unless the media is an explicitly labeled media alternative for text. Source: W3C WAI ().
- Practical caption placement guidance includes safe-zone placement and no more than two lines per caption. Source: DCMP Captioning Tip Sheet ().
- Netflix timed-text general requirements specify a 5/6-second minimum and 7-second maximum subtitle event duration for Netflix deliveries; do not generalize these as universal requirements for all platforms. Source: Netflix Partner Help ().
- YouTube Shorts facts verified on 2026-07-10: square or vertical videos up to 3 minutes are categorized as Shorts for standard channels when uploaded on or after 2024-10-15; YouTube also states Shorts views count starts/replays from 2025-03-31. Sources: YouTube Help (, ).
- TikTok ads facts verified on 2026-07-10: TikTok's ad policy states ad video duration must be 5-60 seconds and use standard video sizes including vertical 9:16, square 1:1, or horizontal 16:9; TikTok's June 2026 in-feed auction specs list Non-Spark vertical recommended 9:16 at at least 540x960, up to 10 minutes, 500 MB max, and safe-zone files. Treat the policy/spec distinction carefully for the placement you are delivering. Sources: TikTok Ads Help (, ).
- Adobe documents Premiere Team Projects and Productions as collaboration/media-management choices; Productions break long projects into smaller projects and rely on shared media access. Source verified 2026-07-10: Adobe Help ().
Empirical observations from generated-media production:
- AI-generated adjacent shots often drift in faces, logos, product geometry, UI copy, hands, scale, reflections, and object permanence even when each clip looks plausible alone.
- Generated clips frequently have strong local motion but weak editorial endpoints: the first and last 6-12 frames may wobble, smear, or change identity. Trimming heads/tails often improves continuity more than re-generating immediately.
- Beat-synced edits feel late if the visual impact happens after the audio transient. In most composition contexts, place the cut or visual hit on the transient or a frame or two before it, then review by eye and ear.
- Platform retention patterns are audience-, category-, and distribution-dependent. Treat "hook in the first seconds" as a testing heuristic, not as proof that every good edit must cut rapidly.
Production heuristics:
- Prefer emotional clarity and story comprehension over clever transitions. A beautiful match cut that obscures causality is a bad cut.
- Every shot should earn its screen time by doing at least one job: orient, reveal, prove, compare, intensify, relieve, bridge, humanize, or close.
- A cut should usually happen when the viewer has received the necessary information, not when the source clip ends.
- A montage should have an argument. "Many cool shots" is not yet a montage.
- Faster pacing is not automatically better. Pace is the controlled contrast between density, rests, anticipations, and payoffs.
Start by defining the edit promise
Before choosing cuts, state the edit promise in one sentence:
> This edit will make the viewer feel/understand/believe/do ___ by arranging ___ into ___ over ___ seconds for ___ platform/context.
Then lock these working decisions:
- Delivery context: ad, trailer, social post, explainer, documentary segment, product demo, music video, internal recap, teaser, or cutdown.
- Primary viewer action: keep watching, understand a concept, feel stakes, trust a claim, click, buy, remember, share, approve, or learn.
- Emotional curve: curiosity to clarity, anxiety to relief, awe to proof, problem to solution, calm authority, escalating hype, playful reveal, investigative discovery.
- Time budget and aspect ratio: target duration, safe-zone needs, caption strategy, platform constraints, audio-on/audio-off assumption.
- Source regime: source footage-led, generated clip-led, stills-to-motion, screen/UI-led, avatar-led, mixed media, or music-led.
- Revision authority: what may change freely, what is locked by client/brand/legal/music/platform, and what requires approval.
If the user only asks "make it snappier," translate that into observable edit changes: shorter shot durations, earlier hook, removed redundancy, stronger audio hits, simpler captions, tighter action matching, or changed story order.
The edit decision ladder
When judging any cut, use this priority order. It is inspired by professional editing traditions that rank emotion, story, rhythm, viewer attention, and spatial clarity, but it is a heuristic, not a law.
- Viewer effect: What should the viewer feel, infer, or ask at this instant?
- Story function: Does the cut advance the promise, reveal, proof, escalation, or payoff?
- Attention path: Does the viewer's eye land where the next shot needs it?
- Rhythm: Does the cut align with breath, speech, movement, beat, or intentional rupture?
- Continuity: Is time, space, identity, screen direction, and causality clear enough for this style?
- Technical cleanliness: Are frames, audio joins, captions, and transitions free of avoidable defects?
If two priorities conflict, explain the tradeoff. Example: "This jump cut violates spatial smoothness, but it improves urgency and removes a dead clause; acceptable for TikTok UGC, not for a calm documentary sequence."
Build the story spine before the timeline
Choose a structure that matches the deliverable.
For explainers:
- Cold open: state the surprising problem, visual metaphor, or before/after.
- Orientation: give the viewer the minimum context needed to follow.
- Steps: one idea per beat; each visual must prove or clarify the narration.
- Synthesis: show how the parts connect.
- Close: memorable sentence, implication, or action.
For product videos:
- Pain or desired outcome.
- Product in use, not just product beauty.
- One feature per beat, tied to a user benefit.
- Proof: UI, result, comparison, testimonial, metric, or demonstration.
- CTA or next step.
For ads:
- Hook: recognizable problem, contradiction, spectacle, person-to-camera line, product-in-action, or fast before/after.
- Relevance: "this is for me" signal.
- Value proposition: one main claim, not a pile of features.
- Proof or demo.
- Offer, urgency, or CTA.
For trailers/teasers:
- World or premise.
- Disruption.
- Escalation through increasingly consequential images.
- Signature moments.
- Final button: joke, shock, title, date, product/logo, or unresolved question.
For documentary-style pieces:
- Claim/question.
- Human anchor or observed reality.
- Evidence beats.
- Counterpoint or complication.
- Synthesis without over-explaining.
For music/beat-driven edits:
- Map sections first: intro, groove, lift, drop, bridge, finale.
- Assign visual energy to musical energy.
- Use repetition with variation: recurring subject, movement, color, framing, or motif.
- Reserve the strongest visual change for the strongest musical change.
Shot selection: assign function, then choose
Log or infer each candidate shot with:
- ID/path/source/provider/seed/version/license/rights status.
- Duration, usable in/out range, frame rate, resolution, aspect ratio, audio status.
- Shot type: establishing, wide, medium, close-up, insert, cutaway, reaction, POV, screen capture, graphic, title, transition, product macro, proof shot, texture.
- Content: subject, action, text visible, brand marks, faces, hands, UI state, object state.
- Motion: camera, subject, dominant direction, speed, start/end pose.
- Continuity risks: identity drift, lighting mismatch, impossible geography, bad hands, text artifacts, logo distortion, physics issues.
- Editorial value: orient, reveal, prove, compare, intensify, bridge, breathe, or close.
Select shots by function, not prettiness. Keep a beautiful generated shot only if it carries story value or emotional force. Reject shots that introduce unpayable questions unless confusion is intentional.
Common shot functions:
- Establishing: where/what scale are we in?
- Insert: what exact detail matters?
- Reaction: how should the viewer feel about what just happened?
- Cutaway: what covers a time jump, compresses action, or adds context?
- Proof: what makes the claim credible?
- Bridge: what lets two discontinuous moments connect?
- Reset: where can the viewer breathe before density rises again?
- Button: what last image or sound seals the beat?
Continuity editing for generated and mixed media
Use continuity when the viewer must believe events are connected in time and space.
Check:
- Screen direction: a subject moving left-to-right should usually keep that direction across adjacent shots unless you establish a turn, neutral shot, or deliberate disorientation.
- Eyeline: if a person looks screen right, the object/person they look at should be positioned to satisfy the implied look.
- Match on action: cut during a movement and continue the same action in the next shot when preserving flow.
- Object permanence: product color, logo, shape, UI state, outfit, props, hand count, and environment should not mutate accidentally.
- Temporal logic: if a cup is full, then empty, then full, the timeline needs a reason.
- Light and color: generated clips with different time-of-day or color temperature need a motivated transition, grade, or separation.
- Spatial scale: avoid cutting from macro to wide if the viewer cannot identify the object being magnified.
- Audio space: room tone, ambience, music bed, and reverb should not jump unless the location changes.
When continuity fails, choose one:
- Hide it: cut away, crop, cover with graphics, use a reaction, or trim unstable frames.
- Motivate it: turn mismatch into a time jump, dream logic, glitch, memory, or montage association.
- Separate it: insert a title card, wipe, sound bridge, flash, map, caption, or chapter beat.
- Regenerate/replace it: if the continuity problem corrupts identity, factual claims, product trust, or safety.
Montage theory for production use
Montage creates meaning from juxtaposition. Use it when sequence matters more than continuous action.
Choose the montage relationship:
- Graphic: shots connect by shape, color, composition, line, texture, or visual mass.
- Rhythmic: shots connect by movement, beat, action speed, or cut length.
- Spatial: shots build or disrupt a sense of place.
- Temporal: shots compress time, compare past/present/future, or imply process.
- Associative: shots create an idea by collision, analogy, contrast, or metaphor.
- Emotional: shots intensify, release, or redirect feeling.
- Evidentiary: shots accumulate proof or examples.
Do not call every fast sequence a montage. A montage needs a transformation, contrast, accumulation, or idea that emerges across shots.
Useful montage patterns:
- Accumulation: one example, then another, then another, until the claim feels proven.
- Compression: remove procedural steps but preserve cause and result.
- Contrast: before/after, promise/reality, old/new, manual/automated, expensive/simple.
- Parallel escalation: two threads become more intense until they meet.
- Motif return: repeat an image or sound with changed meaning.
- Conceptual collision: place two images together so the viewer infers the relationship.
Avoid weak montage patterns:
- Random B-roll over narration.
- Visual synonyms that repeat the script literally without adding information.
- Unmotivated speed ramps and whip transitions.
- Cutting on every beat with no phrase-level shape.
- Visual escalation that arrives before the story stakes are established.
Rhythm and pacing
Pacing is the viewer's perceived information flow, not just average shot length.
Shape rhythm with:
- Shot duration.
- Motion speed inside the frame.
- Narration density and pause length.
- Music tempo, bars, fills, drops, and transients.
- Caption length and reading speed.
- Visual complexity.
- Sound design attacks, risers, impacts, whooshes, silence.
- Repetition, variation, and rest.
Use faster cuts when:
- The viewer already understands the subject and needs energy.
- The beat is emotional rather than explanatory.
- The platform rewards immediate clarity and novelty.
- The source footage has redundant action.
- The music is the structural driver.
Use slower cuts when:
- The viewer must read UI, captions, labels, charts, or product details.
- A reaction, reveal, or emotion needs time to land.
- The shot contains complex spatial information.
- The voiceover is dense.
- The brand tone is premium, calm, technical, or documentary.
Review rhythm in passes:
- Silent picture pass: does the visual story read without narration?
- Audio-only pass: does the argument, emotion, and timing work without picture?
- Caption-only pass: can a sound-off viewer understand the video?
- Full pass: do picture, audio, captions, and graphics compete or cooperate?
J-cuts, L-cuts, and sound bridges
Use split edits to make edits feel intentional and to bridge discontinuous visuals.
J-cut:
- Best for entering a new scene, thought, location, speaker, or energy before the viewer sees it.
- Use when the next beat should pull the viewer forward.
- Example use: hearing crowd noise before cutting from a quiet product close-up to a launch event.
L-cut:
- Best for preserving emotion, explanation, or ambience while the picture moves on.
- Use when a speaker's words should carry over proof shots, reactions, product inserts, or memory images.
- Example use: founder says "we almost missed payroll" while the image cuts to empty desks and a late-night spreadsheet.
Sound bridge:
- Use ambience, music, breath, effects, or a repeated sound motif to connect shots whose images do not match.
- Keep room tone and music continuity clean; abrupt audio holes are often more distracting than visual discontinuity.
Match cuts, cutaways, transitions
Match cut:
- Connect shots through matched action, composition, shape, motion, color, sound, or concept.
- Use for elegance, compression, metaphor, or continuity.
- Do not use if the viewer needs a clear factual boundary and the match implies a false equivalence.
Cutaway:
- Use to compress time, hide a jump, show context, redirect attention, cover a bad generated frame, or add proof.
- Prefer cutaways that add meaning, not generic filler.
- In interviews or documentary edits, cutaways should relate to the statement being made or reveal a truthful context.
Transition:
- A straight cut is usually the default.
- Use dissolves for time passage, memory, softness, or comparison when motivated.
- Use wipes, whip pans, flashes, glitch, morphs, or animated transi
…
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: calesthio
- Source: calesthio/generative-media-skills
- License: MIT
- Homepage: https://github.com/calesthio/OpenMontage
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.