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
/plugin marketplace add artemnovitckii/claude-editing-skills
/plugin install editing-skills@claude-editing-skillsWhat 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
/storytellingon this clip
How to install storytelling
1Plugin marketplace
/plugin marketplace add artemnovitckii/claude-editing-skills/plugin install editing-skills@claude-editing-skillsThis installs the whole editing-skills plugin with all its skills
2Skills CLI (Vercel)
npx skills add artemnovitckii/claude-editing-skills --skill storytelling -a claude-code3Manually: put the files in place
~/.claude/skills/storytelling/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/storytelling/
1Skills CLI (Vercel)
npx skills add artemnovitckii/claude-editing-skills --skill storytelling -a codex2Manually: put the files in place
.agents/skills/storytelling/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add artemnovitckii/claude-editing-skills --skill storytelling -a cursor2Manually: put the files in place
.cursor/skills/storytelling/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install artemnovitckii/claude-editing-skills skills/storytelling2Manually: put the files in place
.github/skills/storytelling/SKILL.md1Skills CLI (Vercel)
npx skills add artemnovitckii/claude-editing-skills --skill storytelling -a gemini-cli2Platform CLI
gemini skills install https://github.com/artemnovitckii/claude-editing-skills --path skills/storytellingManually: put the files in place
.devin/skills/storytelling/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.