Transcript-Backed Vertical Clip Editor

# Transcript-Backed Vertical Clip Editor

Find a strong excerpt in a supplied long-form video and produce one reviewed vertical clip.

## Required Aident Actions

- <action-tag>direct:fal:fal_speech_to_text</action-tag> (required inputs: inspect the current schema): Run an active Fal speech-to-text model. Defaults to fal-ai/speech-to-text/turbo. Call fal_list_speech_to_text_models before selecting another model to inspect current pricing, required fields, defaults, and model...
- <action-tag>direct:fal:fal_list_media_analysis_models</action-tag> (required inputs: inspect the current schema): List active Fal image and video understanding models with current platform-key pricing, descriptions, required inputs, defaults, choices, documentation links, and pagination cursors. Use this before fal_analyze_media...
- <action-tag>direct:fal:fal_analyze_media</action-tag> (required inputs: inspect the current schema): Run an active Fal image and video understanding model. Defaults to fal-ai/florence-2-large/more-detailed-caption. Call fal_list_media_analysis_models before selecting another model to inspect current pricing,...
- <action-tag>cli:ffmpeg:trim_mp4</action-tag> (required inputs: inputUrl, startSeconds, durationSeconds): Extract a time range from a video and return it as an H.264 and AAC MP4 asset.
- <action-tag>composio:shotstack_tools:shotstack_render_video</action-tag> (required inputs: timeline, output): Tool to initiate a new video render job. Use when you have defined a timeline and output settings and want to start rendering.
- <action-tag>composio:shotstack_tools:shotstack_get_render_status</action-tag> (required inputs: id): Tool to retrieve the current status and details of a Shotstack render job by render ID. Use when polling a render until done or failed, typically after creating a render with SHOTSTACK_RENDER_VIDEO.

Use Aident Loadout to read the current Action schema before constructing inputs. Check the required integration connection in Aident Vault. If an Action is billable or mutating, run Aident preflight, show the affected target and quoted cost or risk, and wait for explicit user confirmation before execution.

## Workflow

1. Confirm the requested outcome, source material, destination, audience, constraints, and acceptance criteria.
2. Apply the source-derived guidance below to create a concrete plan. Resolve ambiguity before invoking an Action.
3. Select only the Aident Actions whose documented effect directly advances the requested outcome. Do not invoke every listed Action by default.
4. Inspect the current schema and prepare the minimum valid input for each selected Action.
5. Preflight each selected Action. Execute it only after any required confirmation, in dependency order, and carry returned IDs or asset URLs into later steps.
6. Verify the returned IDs, URLs, statuses, or artifacts against the acceptance criteria. Report partial completion precisely and do not repeat paid or mutating calls blindly.

## Source-Derived Guidance

- Collect the source video asset, target duration, vertical aspect ratio, audience, and excerpt-selection criteria.
- Use direct:fal:fal_speech_to_text for a timestamped transcript, then use direct:fal:fal_list_media_analysis_models to select a current model that explicitly supports video input.
- Use direct:fal:fal_analyze_media for visual context around candidate excerpts.
- Present the proposed start and end timestamps, transcript excerpt, and rationale before editing.
- Use cli:ffmpeg:trim_mp4 to extract the approved interval and composio:shotstack_tools:shotstack_render_video only when a vertical composition or reviewed overlays are required.
- Verify duration, framing, transcript continuity, audio-video sync, and playback before returning the clip asset.

## Execution Boundaries

- Treat upstream provider-specific commands as background knowledge only. Execute the workflow through the exact Aident Actions above.
- Never request raw credentials in chat. Use Aident Vault connection flows for required accounts.
- Preserve user-provided wording, brand constraints, rights restrictions, and target identifiers. Do not invent authorization.
- Pass assets by Aident asset ID or supported URL fields. Do not expose caller-local filesystem paths to hosted Actions.
- After Shotstack accepts a render, pass its returned ID to composio:shotstack_tools:shotstack_get_render_status at moderate intervals until a terminal state. Return a video URL only after the render completes.
- Stop when a required integration is disconnected, preflight rejects the input, the target is ambiguous, or the user declines a required confirmation.

## Output

Return the execution plan, selected Action names, confirmed targets, Aident result identifiers or asset URLs, verification evidence, and any remaining blocked step.

## Attribution

This Skill adapts the reviewed upstream workflow. See [UPSTREAM.md](UPSTREAM.md) for the pinned source and [LICENSE.txt](LICENSE.txt) for the preserved license.