technical-video-script skill (samber): write a shootable screencast script

Writes or reviews a shootable script for a technical video or screencast: beat table, hook, chapters, cut list and description.

Installs: 12.8K; on skills.sh
Stars: 7; on GitHub
Files: 5; besides SKILL.md
Updated: Nov 2026; last repo commit

technical-video-script makes your agent turn a source (a post, changelog, demo or nothing yet) into a script someone can record from. Each beat says what is on screen, what happens and the exact words spoken, and the script ends with a cut list and a description with one call to action. SKILL.md says it does not record, edit, render or publish.

It triggers on a screencast, demo or walkthrough video, a Shorts, TikTok or Reels script, an animated explainer, or viewers dropping off in the first minute. The folder holds SKILL.md and four reference files and bundles no scripts.

Good for

Developers and DevRel staff turning a blog post or changelog into a video
Anyone recording a screencast who wants a script that can be re-shot beat by beat
Teams whose video loses viewers early and who want the beat that caused it

Install technical-video-script

Claude Code

Copy this prompt.

Install the technical-video-script skill in Claude Code. Run this command:

/plugin marketplace add samber/developer-relations-skills
/plugin install developer-relations-skills@developer-relations-skills

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

The README recommends installing the whole collection because its skills reference each other, and technical-video-script names other skills in the collection to hand work to. The whole-collection routes add all 93 skills in the repo (counted from the git tree); the repo holds no hooks, agents, commands or MCP server files, and 14 of its skills bundle a script. Pick one route per agent.

From the project README. Source.

What's in the skill

When it loads

Writes or reviews a shooting-ready script for a technical video or screencast - a two-column visual/narration beat sheet with a 30-second hook, code-on-screen pacing, chapters, a runtime budget, accessible narration, a cut list and a YouTube description with one CTA. Also storyboards 2-5 minute animated or motion design explainers. Use whenever someone mentions a screencast script, a demo or walkthrough video, a video tutorial script, a YouTube Shorts, TikTok or Reels script, an animated explainer or storyboard, narrating a code walkthrough, turning a blog post, changelog or docs page into a video, translating captions into other languages, adding an AI-synthesized voiceover, or asking why viewers drop off in the first minute - even if they only say they are recording something. Not a live stage demo - use samber/developer-relations-skills@developer-live-demo-design. Not video editing or podcast guesting.

Sections in SKILL.md

Interview
Workflow
Video shapes
The opening beat
Beat format
Code on screen
Segments, chapters and metadata
Narration language
Reviewing a script you did not write
Invocation examples
Promise
Beats
Chapters
Cut plan
Recording brief
Runtime

Key facts

Author: Samuel Berthe (samber)
License: MIT (LICENSE file, SKILL.md, plugin.json and README all say MIT)
Installs on skills.sh: 12,750 (as of Nov 2, 2026)
GitHub stars: 8 for the whole collection repo (Nov 2, 2026)
Last commit: Nov 1, 2026 (whole repo)
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn
What is inside: 6 files including SKILL.md: 4 reference files and evals/evals.json
Version in SKILL.md: 1.1.4
Needs: SKILL.md lists nothing to install. If the agent can browse the web, it re-checks the video platform's chapter rules
Works in: Claude Code, Claude.ai (plugin marketplace), Codex, Cursor, Gemini CLI and other Agent Skills-compatible tools
Part of: The developer-relations-skills plugin (one plugin in marketplace.json)
Collection size: 93 skills in the repo (counted from the git tree)

What it includes

Asks thirteen questions one at a time until the promise, viewer and source are clear.
Refuses adjectives like "polished" and converts them into runtimes or on-screen artefacts. If nothing is written yet it runs a short topic round first.
Interview
Writes one sentence: for this viewer, this video shows this thing working.
If the sentence needs an "and", SKILL.md says you have two videos.
Extract the promise
Ranks eight video shapes and deletes the ones your constraints rule out.
Error/fix video, changelog clip, short-form clip, feature walkthrough, motion design explainer, concept explainer, build-along tutorial and deep dive.
Pick the shape
Writes the first 30 seconds first: the problem, the result running, prerequisites.
Ceremony such as channel branding gets about five seconds. Short-form clips skip this window and open on the payoff.
The opening beat
Writes each beat as a row with six fields.
Visual, On-screen action, Narration, Starting state, Est. seconds and Core/cuttable.
Beat format
Sets pacing rules for code and bans narration like "as you can see here".
The terminal 24pt and editor 20pt floors are labelled as the skill's own baseline, not a published standard.
Code on screen and narration language
Attaches chapters and a description with one call to action.
SKILL.md lists four chapter requirements for the dominant video platform and says to re-check them if you can browse the web.
Network · Chapters and metadata
Diagnoses an existing script instead of rewriting it.
Three causes: a logic break, a density drop or an unspeakable line. Findings are graded high, medium or low risk and show the original line next to the suggestion.
Try: “Why do people drop off at 1:40 in this video?”
Reviewing a script you did not write
Iterates until seven gates hold before calling the script shootable.
Includes a cut list that still delivers the promise when every cuttable beat is removed.
Pass threshold

From the official docs

Permissions

Low risk

The agent can save notes about your company or project to a file called devrel-context.md, so check that file before you commit or share the folder.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It may browse the web for chapter rules
SKILL.md says to re-check the current chapter rules if the agent can browse the web, and to say they were not re-verified if it cannot. Our advice: confirm the rules on the platform before you publish. github.com
It may keep notes in devrel-context.md
SKILL.md tells the agent to store a few details about the current task or project, and to use a file called devrel-context.md when its memory lives in a file. Our advice: open that file before you commit or share the folder. github.com
The plugin route installs the whole collection
The README's plugin and extension routes add every skill in the repo; its git tree holds 93. The repo has no hooks, agents, commands or MCP server files, and 14 of its skills bundle a script. Our advice: use the skills CLI command for this skill if you want only it. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	SKILL.md describes no read-only mode.
Scopes	May browse the web to re-check the video platform's chapter rules (SKILL.md, Segments, chapters and metadata)

Questions

How do I install technical-video-script?

The README says to install every skill in the collection, because its skills reference each other. In Claude Code that is the plugin route in the install box above, which adds all 93 skills in the repo. The skills CLI can add just this one. Our advice: pick one route per agent.

What do I get at the end?

A script with a Promise, a Beats table, Chapters, a Cut plan, a Recording brief and a Runtime estimate. Each beat carries a starting state so it can be re-shot alone.

Will it record or edit the video?

It will not. SKILL.md says "You do not record, edit, render or publish." The script is the deliverable, finished when someone who did not write it could shoot it on a clean machine.

technical-video-script vs developer-live-demo-design?

Use this skill for recorded video and developer-live-demo-design for a live stage demo. SKILL.md says "Not a live stage demo", and the README describes the other skill as engineering a demo to survive the stage.

Can it check my retention numbers?

It works from the retention curve and script you give it. SKILL.md has the agent map dips to specific beats and return graded findings, not a rewrite.

Does technical-video-script need an API key, and where does it work?

SKILL.md names no API key, account or environment variable. The README documents installs for Claude Code, Claude.ai (add the repo as a plugin marketplace), Codex, Cursor, Gemini CLI and any Agent Skills-compatible tool through the skills CLI. The install box has the steps for each.

Is technical-video-script safe to install?

It is instructions plus four reference files, and the folder bundles no scripts. SKILL.md says the agent may browse the web to re-check chapter rules and may save project notes to devrel-context.md. Our advice: keep customer data, tenant IDs and internal hostnames out of what you paste in, since the script is meant to be recorded and shared.

Information

updated Nov 2, 2026

Repository: samber/developer-relations-skills
Folder: skills/technical-video-script

samber/developer-relations-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 2

developer-relations-skills README · github.com
technical-video-script SKILL.md · github.com