video-short

Generates 45-60 second vertical video shorts for Ethereum protocol explorations using ElevenLabs, Playwright, and ffmpeg.

4|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/feelyourprotocol/website --skill video-short-feelyourprotocol
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: video-short
Source: https://github.com/feelyourprotocol/website/tree/main/.cursor/skills/video-short
Command: npx skills add https://github.com/feelyourprotocol/website --skill video-short-feelyourprotocol

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Producing a polished vertical short (YouTube Shorts / Reels / X) for each Feel Your Protocol exploration requires coordinating narration scripts, voice synthesis, browser recording, video muxing, and social copy — a multi-tool pipeline that is error-prone when done by hand. ## Core Features & Use Cases - End-to-end video pipeline: Derives a beat-by-beat plan from an exploration's canonical.ts, drafts content.json / playbook.json / zones.json / narration.json, synthesizes voice with ElevenLabs, records the widget with Playwright, and muxes a 1080x1920 H.264/AAC *-final.mp4 with ffmpeg. - Hard QA gates: Three-tier validation (vitest suites, storyboard + Playwright rehearsal, Chromium preflight) plus codec, frame-0, audio-start, and duration verification before shipping. - Publication assets: Writes tweet.yml (announcement thread with intent URLs and accessibility description) and youtube.yml (title, description, tags, playlist, auto-extracted title-card thumbnail) for X and YouTube Shorts. - Use Case: After finishing an EIP exploration, ask for a short video; the skill registers the exploration, adds missing data-testid hooks, runs the full pipeline, and reports a clickable local file URL to the final 1080x1920 mp4 plus paste-ready social copy. ## Quick Start Generate a video short for EIP-7708, running the full pipeline from narration synthesis through the final 1080x1920 mp4 and publication assets.

Frequently Asked Questions about video-short

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a vertical video short for an EIP exploration?▼

Run the video-short skill with the exploration id. It derives a beat plan from canonical.ts, drafts the four project JSON files, passes QA tiers, synthesizes ElevenLabs narration, and runs npm run video:generate to produce the 1080x1920 final mp4.

What tools does the video generation pipeline use?▼

The pipeline combines ElevenLabs for text-to-speech with character-level timestamps, Playwright for recording the exploration widget at 540x960, and ffmpeg for muxing and 2x upscaling to a 1080x1920 H.264/AAC mp4.

Why does X reject my uploaded video with incompatible video codecs?▼

X rejects VP9-in-MP4, which Chromium records by default. The mux step always transcodes to H.264 with yuv420p and faststart; if ffprobe shows VP9 on an old file, re-run npm run video:voice:mux to re-encode.

Can the skill run without an ElevenLabs API key?▼

No. Preflight checks for ELEVENLABS_API_KEY and ELEVENLABS_VOICE_ID via a non-printing exit-code check and stops if missing. The human must copy video/.env.example to video/.env and add their key; the skill never reads or prints the secret.

Why does a Playwright click fail on the hardfork toggle or receipts panel?▼

Video capture hides the right-panel host until expandCompanion is half or full, and the open sheet blocks stepper controls. Inventory each click target as main or companion and insert expandCompanion steps before clicking.

Does the skill upload the video to YouTube or X automatically?▼

No. It only produces the final mp4, tweet.yml, youtube.yml, and a title-card thumbnail. Upload happens later via round-trip-close or manually with npm run video:youtube:upload after OAuth setup.