paw-cra-video-shortform
Short-form video pipeline for Reels, TikTok, and Shorts. Use when user requests 'create short video', 'make a Reel', 'TikTok video', or 'short-form video'.
How do I install this agent skill?
npx skills add https://github.com/pawbytes/skill-suites --skill paw-cra-video-shortformIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill automates short-form video creation by coordinating AI generation, voiceover APIs, and video editing tools. It handles local file organization and path resolution through a dedicated script. Security analysis identifies risks related to indirect prompt injection from processed files and the execution of external commands for video processing.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Short-Form Video Pipeline
Overview
This workflow produces upload-ready short-form vertical video (15-90 seconds) for TikTok, Instagram Reels, and YouTube Shorts. It takes a brief or script and outputs a finished MP4 (1080x1920, H.264) with burned-in subtitles and a video-manifest.json.
Args: Accepts --headless / -H for non-interactive execution. Requires a brief with at minimum: topic, duration, platform, and brand.
Output: MP4 video file + video-manifest.json saved to {suite-root}/brands/{brand}/videos/short-form/ (or the campaign's videos/short-form/).
Act as a technical video production specialist who orchestrates AI generation tools and ffmpeg into a cohesive short-form video pipeline. You understand both creative storytelling (hooks, pacing, visual beats) and technical video engineering (codecs, resolution, safe zones, platform limits).
Design rationale: This workflow is production-first -- it accepts briefs directly without a mandatory Strategist gate. The Strategist is available on-demand for script writing when the user does not provide one. The codec validation step (Step 9) serves as the embedded review gate, replacing the old standalone cra-video-review-gate. Every run produces a tangible video file plus machine-readable manifest.
On Activation
Load available config from {project-root}/.pawbytes/config/config.yaml and {project-root}/.pawbytes/config/config.user.yaml (root level and cra section). If config is missing, let the user know paw-cra-setup can configure the module at any time. Resolve and apply:
{user_name}(null) -- address the user by name{communication_language}(English) -- use for all communications{document_output_language}(English) -- use for generated document content{fal_key}(null) -- fal.ai API key for video generation{elevenlabs_api_key}(null) -- ElevenLabs API key for voiceover (optional){suite-root}isrootfromuv run {skill-root}/scripts/paw-paths.py detect({skill-root}is this skill's folder), normally{project-root}/paw-suites/creative. Every{suite-root}/...path below is relative to it. A custom folder in configcra.output_directorywins (detectlists it underoverrides; an old default is not one).- When
detectreportsmode: legacyorboth, the user's files are still partly in the old.pawbytes/creative-suites/tree. Pass every path throughpaw-paths.py locate <path>(add--writefor a new file) and use the path it returns. Once per session, tell the user thatpaw-cra-setupcan move them topaw-suites/creative/, and offer it. Keep working either way. {default_brand}(null) -- default brand name
Load shared agency memory from {suite-root}/_memory/index.md. If an active brand is set, load {suite-root}/brands/{brand}/guidelines.md.
Tool verification: Check for fal_key (required), ffmpeg availability (required), egaki CLI (required for AI video generation), elevenlabs_api_key (optional, for voiceover). Report any missing tools and inform the user which capabilities are limited.
If --headless or -H is passed, load ./references/headless-mode.md and execute without interaction.
Otherwise, greet the user, report tool readiness, and begin brief intake.
Pipeline
The pipeline runs in three phases. Each phase loads its reference on demand.
Phase 1: Pre-Production
Steps 1-4 -- From brief to storyboard with brand context loaded.
Load ./references/pre-production.md to execute.
Covers: brief intake and parsing, script check (use provided script or optionally invoke Strategist), storyboard planning (3-8 scenes with visual direction per scene), and brand context loading.
Progression: Storyboard is confirmed (user approval in interactive mode, auto-approved in headless).
Phase 2: Production
Steps 5-8 -- Generate scenes, audio, assemble, and add subtitles.
Load ./references/production.md to execute.
Covers: AI scene generation via egaki CLI / fal.ai API (Veo 3.1 or Kling v3), voiceover generation via ElevenLabs (if needed), ffmpeg assembly with transitions (xfade) and audio overlay, and subtitle generation with burn-in (styled, safe-zone positioned).
Progression: Assembled video with subtitles exists as a file on disk.
Phase 3: Validation and Export
Steps 9-11 -- Verify, export, and log.
Load ./references/validation-export.md to execute.
Covers: codec validation (1080x1920, H.264, duration check, file size under platform limits), export to {suite-root}/brands/{brand}/videos/short-form/ (campaign work: {suite-root}/brands/{brand}/campaigns/{campaign}/videos/short-form/) with video-manifest.json, and status update to campaign status and daily log.
Progression: video-manifest.json written, daily log updated.
Tool Dependencies
| Tool | Purpose | Required |
|---|---|---|
| egaki CLI | Multi-provider AI video generation (Veo, Kling) | Yes |
| fal.ai API | Veo 3.1, Kling v3 (text-to-video, image-to-video) | Yes |
| ffmpeg | Scene concatenation, xfade transitions, audio overlay, subtitle burn-in, encoding | Yes |
| ElevenLabs API | AI voiceover generation | Optional |
| paw-cra-agent-strategist | Script writing (invoked on-demand when no script provided) | Optional |
Platform Specifications
| Platform | Max Duration | Resolution | Aspect | Max File Size |
|---|---|---|---|---|
| TikTok | 60s | 1080x1920 | 9:16 | 287 MB |
| Instagram Reels | 90s | 1080x1920 | 9:16 | 250 MB |
| YouTube Shorts | 60s | 1080x1920 | 9:16 | 256 MB |
Memory
Reads:
{suite-root}/_memory/index.md-- active brands, campaigns{suite-root}/brands/{brand}/guidelines.md-- brand identity{suite-root}/brands/{brand}/campaigns/{campaign}/brief.md-- campaign brief{suite-root}/brands/{brand}/campaigns/{campaign}/scripts/-- approved scripts
Writes:
{suite-root}/brands/{brand}/videos/short-form/(or the campaign'svideos/short-form/) -- video assetsvideo-manifest.jsonin that folder -- manifest{suite-root}/brands/{brand}/README.md--Status:/Next:and links after a delivery; thenuv run {skill-root}/scripts/paw-paths.py index{suite-root}/_memory/daily/{YYYY-MM-DD}.md-- activity log
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/pawbytes/skill-suites/paw-cra-video-shortform">View paw-cra-video-shortform on skillZs</a>