Skip to content
Back to skills

Paw Cra Video Shortform

ASecurity

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'.

  • 116 stars
  • 0 votes
  • 0 copies
  • 5 views
  • Added September 10, 2026
content-marketingapi

Works with

  • cli
  • api

Security analysis

A100/100

Pro scans all 5 files and shows the line behind each finding

Scanned November 9, 2026

npx -y skills add pawbytes/skill-suites --skill paw-cra-video-shortform --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Paw Cra Video Shortform?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Paw Cra Video Shortform
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/pawbytes-paw-cra-video-shortform/badge)](https://www.skillsdirectory.com/skills/pawbytes-paw-cra-video-shortform)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: paw-cra-video-shortform
description: 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'.
---

# 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}` is `root` from `uv 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 config `cra.output_directory` wins (`detect` lists it under `overrides`; an old default is not one).
- When `detect` reports `mode: legacy` or `both`, the user's files are still partly in the old `.pawbytes/creative-suites/` tree. Pass every path through `paw-paths.py locate <path>` (add `--write` for a new file) and use the path it returns. Once per session, tell the user that `paw-cra-setup` can move them to `paw-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's `videos/short-form/`) -- video assets
- `video-manifest.json` in that folder -- manifest
- `{suite-root}/brands/{brand}/README.md` -- `Status:`/`Next:` and links after a delivery; then `uv run {skill-root}/scripts/paw-paths.py index`
- `{suite-root}/_memory/daily/{YYYY-MM-DD}.md` -- activity log

Files in this skill

  • SKILL.md5.7 KB
  • references/headless-mode.md2 KB
  • references/pre-production.md3.6 KB
  • references/production.md6.3 KB
  • references/validation-export.md4.4 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in content-marketing →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.