Skip to main content
skill CX Codex

storytelling · artemnovitckii — Claude Code skill: video edits and setup

A skill for Claude Code turns a talking-head clip into a vertical story reel with three cards and captions. It starts with /storytelling or a request for a story, proof, or lead-magnet edit from 9:16 footage.

MIT ★ 94 updated 2026-10-30

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add artemnovitckii/claude-editing-skills
/plugin install editing-skills@claude-editing-skills
Open on GitHub

What storytelling does

The skill builds a vertical reel from a talking-head video, placing three image or data cards, a black-backed title, a white subtitle, and short captions over one continuous take. All three cards appear together. The selected story or proof section runs for 4–8 seconds without stitched cuts.

A script transcribes the footage, then builds the edit from a JSON spec containing the video, clip boundaries, zoom, cards, and text. It produces <out>.sheet.jpg for a visual check; the finished MP4 is handed over by file path.

Transcription needs GROQ_API_KEY. The setup also requires ffmpeg, Node, and Python; first-run setup uses setup.sh.

What it helps with

  • Turn a talking-head clip into a vertical reel
  • Present a story through three image or data cards
  • Add a title, subtitle, and short captions
  • Build a proof reel from one continuous segment

Example prompts for the agent

  • Edit this clip as a story with three cards and a title
  • Make a proof reel from this 9:16 footage
  • Run /storytelling on this clip

How to install storytelling

1Plugin marketplace

/plugin marketplace add artemnovitckii/claude-editing-skills
/plugin install editing-skills@claude-editing-skills

This installs the whole editing-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add artemnovitckii/claude-editing-skills --skill storytelling -a claude-code

3Manually: put the files in place

~/.claude/skills/storytelling/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/storytelling/

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

Questions about storytelling

How do I install storytelling in Claude Code?

Add the marketplace with /plugin marketplace add artemnovitckii/claude-editing-skills, then install the plugin with /plugin install editing-skills@claude-editing-skills.

What does storytelling do?

It turns a continuous talking-head segment into a vertical reel with three cards, a title, a subtitle, and short captions. A JSON spec controls the edit.

What does storytelling need to run?

Transcription requires GROQ_API_KEY. The setup also needs ffmpeg, Node, and Python.

Source text

SKILL.md · MIT
---
name: storytelling
description: Edits a talking-head clip into a storytelling reel. Three simple image cards run across the top, with a bold black-box title and a small white subtitle under them, all landing together over one continuous take with simple TikTok-style captions (white, black outline, 1 to 3 words). Use when the user runs /storytelling or asks for a story or proof reel, "three images and a title", or a lead-magnet style edit on a 9:16 clip.
---

# /storytelling

```
┌──────────────────────┐
│ [4:12] [cover] [comments] │  three cards, all at once
│  I made this carousel │  black-box title, 1-2 lines
│   in a few minutes    │
│ and it's doing well   │  small white subtitle
│        (face)         │  one continuous take, punched in a little
│     entire carousel   │  TikTok captions
└──────────────────────┘
```

## First use
This skill's folder is the "Base directory" Claude Code shows when it loads it.
```bash
SKILL_DIR="<base directory of this skill>"   # the path Claude Code printed as "Base directory for this skill"
KIT=$(python3 -c 'import os,sys;print(os.path.realpath(os.path.join(sys.argv[1],"..","..","kit")))' "$SKILL_DIR")
PY="$KIT/.venv/bin/python"; [ -x "$PY" ] || bash "$KIT/setup.sh"
```
`GROQ_API_KEY` must be set to transcribe. Needs ffmpeg and Node.

## Steps
1. **Clip.** Any 9:16 talking head.
2. **Words.** Run `"$PY" "$KIT/reel.py" words <video>`. It prints one sentence per line with `[ends …]` (when its last word ends), so use that as `end`. Pick ONE continuous stretch of 4 to 8 seconds that tells a small story or shows proof. Don't stitch pieces together, because the jump cuts read as weird here.
3. **Spec.** Write `<clip>.storytelling.json` (below). Paths in a spec are relative to the spec file. The three cards are the story in pictures: the effort, the thing and the result.
4. **Build.** Run `"$PY" "$SKILL_DIR/build.py" <spec.json>`.
5. **Check.** Look at `<out>.sheet.jpg`:
   - The cards and title clear the top 220 px.
   - The captions don't cover the mouth (move `caption_top`, 1385 by default).
   - The title fits on its lines.
6. **Hand over** the mp4 path.

## Spec
```json
{
  "video": "my-clip.mp4", "start": 42.3, "end": 47.8,
  "zoom": 1.3,
  "cards": [
    {"type": "stat", "label": "TIME SPENT", "value": "4:12", "unit": "minutes"},
    {"type": "cover", "image": "my-photo.jpg", "text": "the best *ai tools*\nto use when\nyou're *young and broke*"},
    {"type": "comments", "title": "Comments", "rows": [["sarah.creates", "CAROUSEL"], ["mike.builds", "CAROUSEL!!"]]}
  ],
  "title": ["I made this carousel", "in a few minutes"],
  "subtitle": "and it's doing extremely well"
}
```
`cards` takes exactly 3, each one of:
- **`image`**: `{"src": "photo.jpg"}`, a square photo.
- **`cover`**: a carousel cover, `image` plus `text` (`*word*` turns yellow, `\n` breaks the line). It drifts slowly.
- **`stat`**: `label`, `value`, `unit` and a ring.
  - The `value` counts up when it is a number (`"250"`, `"10,000"`) or a time (`"4:12"`).
  - `ring` (0 to 1) is how full the ring gets.
- **`comments`**: up to 4 `[handle, text]` rows.
- **`text`**: `{"big": "3×", "small": "more saves"}`.

The other fields:
- **`title`**: 1 or 2 lines, each about 22 characters at most.
- **`subtitle`**: one short line.
- **`zoom`**: how far the take is punched in. 1.3 by default, 1 for none.

## Taste
- Everything lands at once, in the first third of a second. Never one at a time.
- The title is the story in one breath. The subtitle is the payoff.
- Cards show real things: the user's own post, numbers, screenshots. Comment rows and handles must be real ones the user gave you. If they have none, use a `text` or `stat` card instead of inventing people.

© Artem Novitckii · MIT · artemnovitckii/claude-editing-skills

Similar skills

All skills for Marketing and content →

storytelling by other authors comes first.

storytelling typeui.sh storytelling — a skill for Claude Code and five other coding agents that turns interfaces into story-driven experiences through visuals, copy, and interaction. It produces implementation-ready design guidelines instead of vague advice. CX Codex +1 2,900installs storytelling ghaida storytelling gives design work a narrative structure: four canonical patterns so journeys, briefs and decks make people care instead of just showing data. CX Codex +1 3,800installs storytelling fal-ai-community The storytelling Claude Code skill plans scene sequences for image and video generation with fal. It turns a story idea into shots with continuity cues. CX Codex +1 537installs storytelling gtmagents storytelling — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that structures narratives around a four-step SCAR arc. Runs when you need campaign copy, a pitch script, or a product launch story. CX Codex +1 121installs html-reel MengTo html-reel converts tweets, web pages, and recorded demos into 9:16 vertical reels. Renders HTML scenes frame by frame and ties visual cuts directly to spoken voiceover timing. CX Codex +1 ★ 7,995repo stars capcut social-media-skills Plans short-form video edits for CapCut, flags music license traps, and prevents ToS leaks. Handy when turning scripts into retention-focused TikToks, Reels, or Shorts. CX Codex +1 1,400installs steal Melvynx The steal Claude Code skill analyzes a reference video's editing and saves the findings as a named style. It then applies that style to a test video and compares the result with the reference. CX Codex +1 1,700installs reel-export charlie947 reel-export turns horizontal or square footage into a 1080 x 1920 vertical file for Reels and TikTok that uploads without washed-out colour. CX Codex +1 3,600installs vlog-pacing appariciojunior vlog-pacing is a Claude Code skill for transcript-based pacing, pause control, scene room, and zoom changes. It runs while building a cut planner or fixing choppy edits. CX Codex +1 ★ 470repo stars reel-editor nicolapocock reel-editor is a Claude Code skill that turns raw talking-head clips into vertical social videos matching brand rules. It triggers on raw video drops, brand setup, or cover requests. CX Codex +1 875installs

From the same set12

The whole set →
shape-shift The shape-shift Claude Code skill builds portrait videos with a match cut between circular subjects. Each subject aligns to one anchor while the speaker stays below the photo panel. CX Codex +1 ★ 94repo stars orbit-reel The orbit-reel Claude Code skill builds portrait videos with image cards moving around a speaker in a 3D ring. Run it to apply this treatment to a portrait clip. CX Codex +1 ★ 94repo stars ranking-list The ranking-list Claude Code skill turns a vertical talking-head clip into a tier-ranking reel. Items appear as they are named, then move into their tier when the speaker gives a verdict. CX Codex +1 ★ 94repo stars trial-reels This Claude Code skill turns one clip into three reels with distinct visual treatments. It runs with /trial-reels or a request for alternate versions of a vertical clip. CX Codex +1 ★ 94repo stars split-screen This Claude Code skill turns a talking-head clip into a vertical split-screen reel. It places visuals above the speaker and captions across the dividing line. CX Codex +1 ★ 94repo stars behind-the-person A Claude Code skill edits vertical talking-head clips with graphics layered behind the speaker. Run /behind-the-person or ask for visuals behind a person. CX Codex +1 ★ 94repo stars explainer This Claude Code skill turns a talking-head clip into a vertical explainer with visuals and captions. It starts with /explainer or a request to put the speaker below the visuals in a 9:16 video. CX Codex +1 ★ 94repo stars editing-skills The editing-skills Claude Code plugin builds vertical videos from talking-head clips and photos. Six workflows time graphics to speech, while five more use photographic templates. ★ 94repo stars

Project sponsors

Companies that keep this analytics open