layer-video-timeline
Use when assembling assets a user already has into one finished video with Layer: sequencing clips, adding transitions, overlaying text, captions, a logo or a CTA, layering music or voice-over, or cutting a trailer, ad, or promo from generated shots. Also when a multi-shot piece needs to become a single deliverable file. Keywords: video editor, timeline, assemble, stitch, sequence, concatenate, transitions, overlay, captions, CTA, trailer, montage, render.
- Installs
- 3.5K
- Last 24h
- +152
- Trending rank
- #1472
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/layerai/skills --skill layer-video-timeline- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads layer-video-timeline automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Layer Video Timeline
Overview
render_video_timeline edits assets the user already has into one finished video: clips in
sequence, transitions between them, text and logo overlays, and layered audio.
estimate_video_timeline_price prices a render without rendering, and get_generation_run polls it.
These three are named directly rather than discovered because they are first-party Layer tools rather than models, with no competing alternative in the catalogue.
This is an assembly step, not a generation step. It composites assets that already exist. Generating
the clips is layer-video, and the shots should be approved before any of them reach a timeline.
If a sibling skill named here is missing from your available skills, ask the user to install it
(npx skills add layerai/skills --skill <name>); unattended, proceed from tool schemas and flag the
gap.
Check for a single-generation answer first
Before assembling, ask whether one video model could render the whole piece. A model that produces a multi-shot sequence in one generation holds its own continuity across the cuts, which assembly cannot do. Assembly is right when the shots must be individually approved, when they come from different sources, or when the piece is longer than any model will render.
Get the inputs right before rendering
Every clip, image, and audio file must already be in the workspace and referenced by file_id.
Generated assets carry one, so they feed the timeline directly. Local files upload first.
Two things to settle before the first render, because both are expensive to fix afterwards:
- One aspect ratio and one resolution for the whole piece. Clips generated at mixed ratios either letterbox or crop, and the crop is where a character's head goes missing. Decide the delivery format first, then generate the shots to it.
- Audio duration against picture duration. A track shorter than the cut ends in silence; a track longer plays over the end card. Trim intent belongs in the timeline, not in a reroll of the music.
Cutting
Shot length carries pace. A montage that holds every shot for the same three seconds reads as a slideshow, so vary it: short shots for energy, longer holds where the viewer must read something.
Transitions are a decision, not decoration. A straight cut is right most of the time. Use a dissolve for a time or location change, and keep any one piece to a single transition vocabulary, because mixing wipes, dissolves, and fades reads as unfinished rather than varied.
For a piece with a CTA, hold the end card long enough to read twice at the viewer's pace, not the editor's.
Overlays
Text overlays must survive the platform. Keep titles and CTAs inside the safe area, well clear of the edges, since social players crop and overlay their own UI at top and bottom. Set type against a plate, a scrim, or a deliberately quiet part of the frame rather than over busy motion.
Generated video is the worst possible background for small text. Where the deliverable has more than a few words, favour a held frame or a plain plate behind them.
Worked example
"Cut these five approved shots into a 20-second vertical ad with our logo and a CTA."
- All five shots came from earlier runs, so they carry
file_idvalues. Confirm they were all generated at 9:16, since mixing ratios here is the common defect. - Upload the logo if it is not already in the workspace, and pick up the music track's
file_id. - Compose the timeline: five clips in order with straight cuts, the logo overlaid small in a consistent corner throughout, a CTA card held at the end, and the music layered under the whole piece.
estimate_video_timeline_pricefirst. Present the table, and above 20 CUs wait for an explicit yes.render_video_timeline, thenget_generation_runatpoll_interval_seconds.- Watch the result end to end before delivering. Check the cut points, that the music resolves rather than stopping dead, and that the CTA sits inside the safe area.
Common mistakes
- Assembling when one model could have rendered the sequence with real continuity.
- Mixing aspect ratios across clips, then discovering the crop on delivery.
- Uploading assets that Layer already produced and that already carry a
file_id. - Holding every shot for the same duration.
- Mixing transition styles inside one piece.
- Putting small text over busy generated motion, or outside the safe area.
- Delivering a render without watching it end to end.
FAQ
What does the layer-video-timeline skill do?
Use when assembling assets a user already has into one finished video with Layer: sequencing clips, adding transitions, overlaying text, captions, a logo or a CTA, layering music or voice-over, or cutting a trailer, ad, or promo from generated shots. Also when a multi-shot piece needs to become a single deliverable file. Keywords: video editor, timeline, assemble, stitch, sequence, concatenate, transitions, overlay, captions, CTA, trailer, montage, render.
How do I install layer-video-timeline?
Run npx skills add https://github.com/layerai/skills --skill layer-video-timeline in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/layer-video-timeline/ (personal) or .claude/skills/layer-video-timeline/ (project).
Which AI agents can use layer-video-timeline?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is layer-video-timeline safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains layer-video-timeline?
It is published by layerai in layerai/skills. It has 3,524 recorded installs.
More from layerai/skills
layer-pixel-art
layerai/skills
Use when making pixel art with Layer: sprites, retro game characters, pixel icons, pixel tiles, or a sprite sheet and walk cycle. Also when generated pixel art comes back blurry, anti-aliased, or at the wrong grid size, and when packing separate frames into a sheet or cutting an existing sheet into frames. Keywords: pixel art, sprite, sprite sheet, spritesheet, 16-bit, 32x32, walk cycle, animation frames, palette, dithering, pack, split.
layer-art-direction
layerai/skills
Use when a Layer brief needs a direction before generating at volume: exploring a look with a moodboard, choosing between visual directions, storyboarding an ad, trailer or cutscene, pinning a colour palette, naming a style or era precisely, or framing a scene. Also when a brief is vague or generations keep missing an unstated intent. Keywords: art direction, moodboard, style exploration, storyboard, panels, beats, palette, composition, framing, era, reference.
layer-game-assets
layerai/skills
Use when producing in-game art with Layer: characters, heroes, NPCs, enemies and mascots, environment and background concept art, parallax layers, or game UI such as icons, buttons, frames, panels, HUD elements and currency symbols. Also when a cast must stay on-model across many images, when an icon must read at 64px, or when a character must be split into parts for a skeletal rig. Keywords: character art, NPC, enemy, concept art, background, parallax, game UI, HUD, icon set, Spine, rigging.
layer-image-editing
layerai/skills
Use when changing an image that already exists on Layer rather than generating a new one: editing or replacing part of it, inpainting with a mask, outpainting or extending the frame, reframing to another aspect ratio, relighting, restyling, re-rendering from another camera angle, splitting into layers, removing a background, vectorising, or upscaling. Keywords: img2img, edit, inpaint, outpaint, mask, expand, turnaround, upscale, background removal, PSD, layers.
layer
layerai/skills
Use when generating or editing game and entertainment assets on Layer through MCP: images, video, 3D meshes, audio, sprites, textures, or marketing creative. Also when choosing a Layer base model, pricing a run in Creative Units before spending them, uploading reference files, polling a generation, applying a trained style, or recovering from MODELNOTFOUND, INSUFFICIENTBALANCE, RATELIMITED, or a silently degraded reference set.
layer-3d
layerai/skills
Use when producing 3D assets with Layer: generating a mesh from text or an image, retopologising or remeshing, retexturing an existing mesh, rigging a character, or animating a rigged mesh. Also when choosing between quad and triangle output, setting a polygon budget, or asking for PBR textures for a game engine. Keywords: 3D, mesh, model, text to 3D, image to 3D, remesh, retopology, retexture, rig, skeleton, animate, PBR, quad mesh, poly count, glTF, FBX.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image