Skip to main content
skill CX Codex

sk-brief — Claude Code skill for short video briefs

sk-brief — a Claude Code skill that shapes a short-video idea into a brief, choosing a story flow and visual types. It checks image licences before any script is written.

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-brief -a claude-code
Open on GitHub

What sk-brief does

The skill prepares the starting brief for a short video and saves it as briefs/<id>.md. It puts the idea into one sentence, checks claims against docs/facts/facts.json, selects a story flow and visual types, then records each image or clip licence in docs/facts/sources.json.

It scaffolds the video folder with bun run new <id> --flow <A..N>, sets the visual IDs in src/videos/<id>/narration.json, and fills in briefs/_template.md. The shorts-kit project files and bun are needed; missing fact records trigger sk-facts. The next pipeline stage is sk-narration.

What it helps with

  • turn a short-video topic into a one-sentence idea
  • choose a story flow and record why another option was rejected
  • map visual types to scenes
  • log fact sources and image licences before scripting

Example prompts for the agent

  • Draft a brief for a short video about X and choose its story flow.
  • Scaffold a folder for a new video and fill in briefs/<id>.md.
  • Check whether this image can be used and record its licence.

How to install sk-brief

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about sk-brief

How do I install sk-brief in Claude Code?

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

What does sk-brief do?

It builds a short-video brief by defining the idea, selecting a story flow and visual types, checking facts, and recording image licences before scripting.

What does sk-brief need to run?

It needs the shorts-kit project files and bun for bun run new <id> --flow <A..N>. When a required fact is missing from docs/facts/facts.json, it runs sk-facts.

Source text

SKILL.md · MIT
---
name: sk-brief
description: Starts a new short by stating the idea in one sentence, picking the storytelling flow and the visual types, checking image licences before any script exists, scaffolding the video folder, and writing briefs/<id>.md. Use when the user says "new video about X", "write a brief", "which flow fits this topic", "how should this look on screen", "scaffold a video", or "can I use this image". Steps 1, 3 and 4 of sk-pipeline.
---

# sk-brief: idea, flow, visuals, brief

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

Rules: `SOUL.md` three first rules, §1, §2 (`docs/soul/01-voice-and-structure.md`),
§5 (`docs/soul/03-visuals.md`), §13 (`docs/soul/10-files.md`). The § wins over
this file.

## Order (do not swap)

1. **One sentence: what can the viewer repeat after watching?** If you cannot
   write it, the topic is not ready. This sentence is the brief's first line.
2. **Facts first.** Every claim you plan to use needs a `verified` record in
   `docs/facts/facts.json`. Missing ones: run `sk-facts` now, before writing.
3. **Pick the flow.** Read `docs/flows/README.md`, then the candidate flow files,
   especially "When to use" and "Traps". Do not default to the first flow out of
   habit: ask what shape the fact has (a list of reasons, a trace back to a cause,
   a single person, a comparison). Sketch at least two shapes, pick one, and note
   in the brief why the other lost.
4. **Pick the visual types** from `docs/visuals/README.md` (e.g. `text-as-image`,
   `timeline`, `archive-plate`, `news-photo`, `gif`, `b-roll`) and read each
   chosen type's file. Flow is how the story is told; visual is how it gets on
   screen. They are independent axes.
5. **Check the licence of every image and clip now.** Record each in
   `docs/facts/sources.json` with its `licence`. An image you cannot license is a
   claim you cannot show; find another visual or cut the claim before scripting.
6. **Scaffold:**
   ```bash
   bun run new <id> --flow <A..N>
   ```
   Then set `visual` in `src/videos/<id>/narration.json` to the chosen ids.
   `id` follows §13 (lowercase, hyphenated, never reused for a different video).
7. **Write `briefs/<id>.md`** from `briefs/_template.md`.

## What the brief holds

- The one-sentence idea and the angle (what the viewer believes now, and the
  turn that negates it).
- Flow chosen, why, and the shape that was rejected.
- Visual types and, per scene, what is on screen.
- A fact table that points at **ids** (`f-0001`), not copied numbers or URLs. A
  copied number goes stale silently when the ledger is corrected.
- Image list with source ids and licences.
- An empty "Posted" section, filled in after upload (`sk-improve`).

## Verify

- [ ] `flow` in `narration.json` matches the flow named in the brief
- [ ] `visual` is set and every id exists in `docs/visuals/`
- [ ] every fact id in the brief exists in `docs/facts/facts.json`
- [ ] every image has a source record with a licence
- [ ] `bun run facts` exits clean

Next: `sk-narration`.

© 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-promo 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. 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

Project sponsors

Companies that keep this analytics open