Skip to main content
skill CX Codex

sk-promo — Claude Code skill for promo videos and setup

The sk-promo Claude Code skill builds ads, launch films, and feature teasers in vertical or landscape formats. It takes a video from the initial brief through storyboard checks and delivery.

MIT ★ 204 updated 2026-11-09

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add howznguyen/shorts-kit --skill sk-promo -a claude-code
Open on GitHub

What sk-promo does

sk-promo guides the creation of an ad or product teaser in 9:16 or 16:9. Work starts with the audience’s problem and the film’s objective, then moves through concept options and a scene-by-scene treatment. The treatment and a timed animatic must be approved before scene code begins.

The workflow supports silent films and voice-over. A silent promo uses promo.json to set scene timing and music; a voiced one uses sk-narration. The skill includes checks for shots, renders, and alternate deliverables. Unchecked asset licences restrict the film to internal use, and the workflow never auto-publishes.

The ingest and cut commands do not support landscape footage yet. Some components are portrait-only, so landscape scenes need separate checks.

What it helps with

  • shape an ad concept around the audience’s problem
  • get approval on a treatment and animatic before scene work
  • prepare promo versions in different formats and lengths
  • check shots and rendered deliverables

Example prompts for the agent

  • Create a 16:9 launch film that promotes this product.
  • Make a silent promo with music and sound effects.
  • Plan a vertical ad with voice-over and shorter cutdowns.

How to install sk-promo

1Skills CLI (Vercel)

npx skills add howznguyen/shorts-kit --skill sk-promo -a claude-code

2Manually: put the files in place

~/.claude/skills/sk-promo/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sk-promo/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sk-promo

How do I install sk-promo in Claude Code?

Run npx skills add howznguyen/shorts-kit --skill sk-promo -a claude-code. The skill file is at ~/.claude/skills/sk-promo/SKILL.md.

What does sk-promo do?

It guides ad, teaser, and product-launch video work from the brief and concept through storyboarding, render checks, and delivery versions.

How does the silent workflow differ from the voice-over workflow?

For a silent promo, promo.json holds scene timing and music. A voiced promo uses sk-narration and a flow.

Source text

SKILL.md · MIT
---
name: sk-promo
description: Makes an ad, TVC, product launch film or feature teaser as a promo, either vertical 9:16 or landscape 16:9, using video.json format and mode. Use when the user says "make an ad", "TVC", "commercial", "product video", "launch film", "promo", "teaser", "quảng cáo", "làm video giới thiệu sản phẩm", "video ngang", "16:9", "landscape", or asks for a video that sells or announces something rather than explains a fact. Not for narrated knowledge shorts (use sk-pipeline).
---

# sk-promo: an ad or TVC, vertical or landscape

**Announce:** "Using sk-promo for <id>."

A promo sells or announces; a short explains a fact. A promo **starts from the pain of the people who use the product** and reveals the product as the answer; a feature tour is not a promo. They share the engine and
differ in rules. Rules: `docs/promo/README.md` (read it first). SOUL's story rules
do not apply; its hard rules do (licences, encode spec, never auto-publish).

## Voice or no voice

- **No voice** (music and sfx, like a TVC): `bun run new <id> --voice none`. The clock
  is `promo.json` (seconds or beats). No narration, TTS, facts file or flow. See
  "A promo with no voice" in `docs/promo/README.md`.
- **Voice-over**: `bun run new <id> --flow <X> --mode promo`, then the normal
  narration path (`sk-narration`).

Read "What is not built yet" in `docs/promo/README.md` and tell the user which of
those their film needs **before** starting (no beat measurement, no strip review,
no page capture yet).

## Steps

| # | Step | How | Evidence |
|---|---|---|---|
| 0 | **Objective and placement.** Copy `briefs/_template-promo.md` to `briefs/<id>.md`. Fill objective, the one measure, CTA (exact words), mandatories, placement (feed ad or launch film) and the deliverables matrix (master, cutdowns, formats, captions) | `docs/promo/README.md` rules 11, 12, 15 | those sections filled and confirmed by the owner |
| 1 | **Pain point first.** Write, in the target user's own words: who they are, the moment they feel the pain, what it costs them. The owner confirms it before anything else is designed. Then the format (portrait or landscape) from where it is watched | `docs/promo/README.md` rules 0 and 1 | pain point written in the brief and confirmed |
| 1a | **Concept routes:** 2-3 routes, each one sentence + key frame + how it shows the pain. The owner picks one; rejected routes and why stay in the brief | `docs/promo/README.md` rule 13 | the chosen route and the rejected ones written |
| 1b | **Treatment, confirmed before any build:** scene by scene in plain words, what the viewer should understand at the end of each (`docs/promo/aesthetics.md` C1-C8): one idea per scene, plain words before product words, a before and after, labels on every number | `docs/promo/aesthetics.md` Clarity | the owner confirmed the treatment |
| 2 | Brief: one sentence, shot list, every asset and its licence. A licence that is not checked makes the film internal-only, and the brief says so at the top | `sk-brief` (skip the flow's "turn" rule) | `briefs/<id>.md` |
| 3 | Scaffold | no voice: `bun run new <id> --voice none --format <portrait\|landscape>`; voice-over: `bun run new <id> --flow <X> --format <..> --mode promo` | `src/videos/<id>/video.json` (+ `promo.json`) |
| 4 | No voice: write `promo.json` (scenes in seconds or beats, music, `bpm` measured, not guessed). Voice-over: write the words | no voice: `docs/promo/README.md`; voice-over: `sk-narration`, and `sk-facts` only for checkable claims (prices, numbers, "first", "only") | `bun run lint <id>` 0 errors |
| 5 | Shot list approved before scene code; every shot has a `size`, and a `card` from `docs/shots/` where one fits | `bun run storyboard <id> --init` (no voice: one shot per promo.json scene, split by `beat`; voice-over: one per line), `docs/storyboard.md`, review in `bun run preview` (Storyboard and Timeline tabs) | every shot `approved` |
| 5a | **Animatic gate:** full-length timed rough cut (one plain card per scene: its big type and a box or still), real music on the grid, scratch voice if voiced. Render it, the owner watches at full speed, and someone new takes the "before" comprehension test (C8). No scene code until it passes | `docs/promo/README.md` rule 14 | animatic rendered; the owner's OK and the stranger's answer written in the brief |
| 6 | Scenes | `sk-scene`; real product components: `docs/promo/real-ui.md`; size and safe area from `useFormat()` / `safeFor()` in `src/shared/format.ts`, never the `W` and `H` in `theme.ts` | `bun run check` clean |
| 7 | Stills with the safe overlay | `bun run still <id> --frame=<n> --safe` | stills opened and looked at |
| 8 | Render, normalize, encode | `sk-render` (size is checked against the video's own format) | ffprobe passes |
| 8a | **Comprehension test:** show the cut to someone who has not seen it; ask what it is for and what changes if you use it; write their answer in the brief (C8) | `docs/promo/aesthetics.md` | their answer names the pain, the product and the benefit |
| 8b | **Review pass:** every rule in `docs/promo/aesthetics.md` answered `✓` or `✗ (shot/frame)`, from a contact strip, ideally by a reviewer who did not make the film; each deliberate break written in the brief | `docs/promo/aesthetics.md` | the pass is written down |
| 8c | **Cutdowns and formats** from the deliverables matrix: each re-edited (pain, product, CTA in its own length), its own composition, checked like the master | `docs/promo/README.md` rule 15 | every row of the matrix has a file that passes ffprobe |
| 9 | Hand-off | `sk-handoff` (a 16:9 cover is not cropped; the 1:1.29 grid crop is for portrait) | every file in the deliverables matrix is in `out/<id>/` |

## Traps

- Components that still import `W`/`H` from `theme.ts` (map, nature, marks, figures,
  chart, FootageStage, PipShot) are portrait only. In a landscape video, check each
  on a still, or make it format-aware with `useFormat()` first.
- The template's `scenes.tsx` uses portrait safe-zone constants. For landscape use
  `safeFor("landscape")`.
- Voiced promo: `bun run lint` still applies the short rules to narration; read its
  warnings as advice, not gates. Voiceless promo: lint checks only the clock and files.
- `bun run render` renders only the `Video` composition; render a cutdown with `bunx remotion
  render` (see "What is not built yet").
- A feed ad that opens on the pain still needs the product name or mark visible by 5 s (rule 12).
- `ingest`/`cut` normalise footage to 1080×1920; landscape footage is not
  supported yet.
- Never auto-publish.

© howznguyen · MIT · howznguyen/shorts-kit

Similar skills

All skills for Marketing and content →

From the same set10

The whole set →
sk-style The sk-style Claude Code skill polishes spoken scripts for short videos while keeping their meaning intact. It activates on requests to tighten wording, improve flow, or remove AI-sounding phrases. CX Codex +1 ★ 204repo stars sk-render The sk-render Claude Code skill renders short videos to MP4, normalizes audio, and prepares the file for upload. It activates for render and export requests, loudness fixes, or reports of broken output. CX Codex +1 ★ 204repo stars sk-facts The sk-facts Claude Code skill checks factual claims and records research in a fact ledger. It starts when a claim, number, source, or media licence needs checking. CX Codex +1 ★ 204repo stars sk-narration sk-narration — a Claude Code skill that writes or edits short-video scripts, generates voice tracks, and runs narration checks. It activates for script, pronunciation, pacing, or voice changes and narration lint errors. CX Codex +1 ★ 204repo stars sk-handoff sk-handoff — a Claude Code skill that prepares a finished short for upload with a cover, encoded video, caption, and pinned comment. It runs on requests to make a thumbnail, write copy, add credits, or prepare the post. CX Codex +1 ★ 204repo stars sk-scene The sk-scene Claude Code skill builds and fixes short-form video scenes in Remotion. It activates for requests to create shots, adjust captions or motion, and check layouts. CX Codex +1 ★ 204repo stars sk-pipeline The sk-pipeline Claude Code skill guides a narrated vertical short from the initial idea to upload-ready files. It activates for new videos, editing supplied footage, or resuming a project. CX Codex +1 ★ 204repo stars sk-improve The sk-improve Claude Code skill adjusts a channel’s rules and storytelling flows rather than editing a finished video. It activates for channel setup, rule changes, or lessons drawn from a posted video’s stats. CX Codex +1 ★ 204repo stars

Project sponsors

Companies that keep this analytics open