add-video

name	add-video
description	Add a new YouTube video to the portfolio. New video becomes Horizontal Video Card 1, all others shift down, oldest goes to More section. Use when user types /add-video followed by a YouTube URL.

Add Video to Portfolio

When the user types /add-video <URL> (optional quoted title and category), run the add script from the repo root. Do not edit video HTML in index.html by hand.

Command

node scripts/add-video.mjs "<URL>" ["Custom Title"] ["Category Name"]

• URL: any YouTube format (watch?v=, youtu.be/, embed/)
• Title: fetched from YouTube oEmbed unless overridden
• Category: defaults to Deep Dives / Demos unless overridden

On success

Confirm the video title and that it is now Horizontal Video Card 1 (featured). Mention /git if the user wants to commit and open a PR.

On failure

Report the script error (stderr). Do not fall back to manual HTML edits.

Data source

Videos are stored newest-first in data/videos.json. The script updates JSON and regenerates the marked section in index.html via scripts/render-videos.mjs.

Rotation (unchanged)

Position	Role
JSON index 0	Horizontal Card 1 (new video)
1	Horizontal Card 2
2–4	Small Cards 1–3
5+	More section (archived)