Skip to content
Back to search

edit-reel

SkillWorks with Claude CodeGitHub

Fully autonomous, zero-interaction video editing pipeline for Instagram Reels and TikTok. Designed for high-signal talking-head educational, scientific, tech, financial, and explanatory content across worldwide languages (English, Spanish, Mandarin, Hindi, Arabic, French, Portuguese, German, Japanese). Features the signature 'Paper & Objects' editorial aesthetic: real camera studio footage for conversational hooks, selective MediaPipe AI person cutout onto warm paper canvas (#E2DDD1) during animated explanations, tangible physical objects (hanging cream tags with gold eyelets, 3D coin stacks, dimensional arrows, rounded icon chips), authentic academic notebook cutoffs for peer-reviewed citations, side-by-side comparative parallel coordinate plots, dynamic rolling odometer counters, kinetic subtitles, broadcast vocal mastering (-11.5 LUFS), ambient background music bed (0.045), and keyframe-locked SFX. Delivers the final production reel autonomously with zero mid-process questions. Trigger with /edit-reel or /reel.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 17 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/MMhaidra/edit-reel with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/MMhaidra/edit-reel'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mmhaidra--edit-reel/badge.svg)](/listings/mmhaidra--edit-reel)

HTML

<a href="/listings/mmhaidra--edit-reel"><img src="/api/listings/mmhaidra--edit-reel/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

1. One-Line Universal Install

curl -fsSL https://raw.githubusercontent.com/MMhaidra/edit-reel/main/install.sh | bash

The script configures a virtual environment, installs vision and acoustic alignment dependencies, and symlinks the skill into your agentic IDEs.

2. Manual Setup

git clone https://github.com/MMhaidra/edit-reel.git
cd edit-reel

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Ensure FFmpeg is available
# macOS:
brew install ffmpeg
# Ubuntu / Debian:
sudo apt-get install -y ffmpeg

3. Run Pipeline on Video

python scripts/pipeline.py \
  -i ~/Desktop/projects/reels_IG/raw_footage.mp4 \
  -s ~/Desktop/projects/reels_IG/script.docx \
  -o ~/Desktop/projects/reels_IG/edited_output \
  --lang en

4. Preview Scene Stills

python scripts/preview_reel_stills.py /tmp/reel_previews

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 235 lines
  1. ---
  2. name: edit-reel
  3. description: >-
  4. Fully autonomous, zero-interaction video editing pipeline for Instagram Reels and TikTok.
  5. Designed for high-signal talking-head educational, scientific, tech, financial, and explanatory content
  6. across worldwide languages (English, Spanish, Mandarin, Hindi, Arabic, French, Portuguese, German, Japanese).
  7. Features the signature 'Paper & Objects' editorial aesthetic: real camera studio footage for conversational hooks,
  8. selective MediaPipe AI person cutout onto warm paper canvas (#E2DDD1) during animated explanations, tangible physical
  9. objects (hanging cream tags with gold eyelets, 3D coin stacks, dimensional arrows, rounded icon chips), authentic
  10. academic notebook cutoffs for peer-reviewed citations, side-by-side comparative parallel coordinate plots, dynamic
  11. rolling odometer counters, kinetic subtitles, broadcast vocal mastering (-11.5 LUFS), ambient background music bed
  12. (0.045), and keyframe-locked SFX. Delivers the final production reel autonomously with zero mid-process questions.
  13. Trigger with /edit-reel or /reel.
  14. ---
  15. # Reel Auto-Editor: Autonomous Production Pipeline for Instagram Reels
  16. This skill enables Antigravity to monitor your raw video folder (`~/Desktop/projects/reels_IG/`) and autonomously produce high-engagement, production-ready 9:16 vertical Instagram Reels with zero user interaction during execution.
  17. ### Content Scope & Language Versatility
  18. The pipeline supports educational, scientific, academic, macroeconomic, business, coding, and explanatory creators worldwide:
  19. 1. **Global Languages**: English (`en`), Spanish (`es`), Mandarin Chinese (`zh`), Hindi (`hi`), French (`fr`), Portuguese (`pt`), German (`de`), Japanese (`ja`), Arabic (`ar` - Modern Standard Arabic and regional dialects including Moroccan Darija `ary`).
  20. 2. **Universal Ground-Truth Policy**: All academic study names, journal titles, and researcher citations are preserved with typographic integrity.
  21. ---
  22. ## The Signature "Paper & Objects" Aesthetic (Primary Default)
  23. Unless `--design glass` is explicitly requested, every pipeline run defaults to (`--design paper`), using an authentic, tactile physical-object visual language:
  24. ### 1. 3-State Alternating Dynamic Rhythm
  25. - **State 1 — Real Studio Footage + Typographic Hook Stamp**:
  26. - Preserves the speaker's authentic camera background during conversational delivery:
  27. - Opening hook (first 5–12 seconds) with optional minimal editorial header stamp above the head.
  28. - Natural thought transitions and breathers between visual concepts.
  29. - Final takeaway and outro.
  30. - Alternates subtle `1.04x` punch-in camera zooms on alternating sentences for viral eye-tracking retention.
  31. - Mixed-script captions (`Arial Bold` Arabic + left-to-right `Helvetica Neue` English runs) float cleanly with soft Gaussian drop shadow.
  32. - **State 2 — 3D Pop-Out Speaker Card on Warm Alabaster Paper (`#F3F0E8`) + Editorial Infographics Above**:
  33. - Frames the speaker's torso and hand gestures cleanly inside an elevated rounded studio card (`190..890, 1155..1730`, zero chopped wrists or floating hand artifacts) while MediaPipe connected-head segmentation pops the speaker's head smoothly out above the card's top border.
  34. - Keeps subtle left/right (`190px`) and bottom (`190px`) buffers completely clear of native Reels UI buttons.
  35. - The upper stage (`y = 156..835`) displays micro-provenance academic eyebrow headers, tactile layered stacks, progressive blush-highlighted Georgia Serif archival excerpts, horizontal benchmark bar charts, label-switch sliders, or paper/notebook objects.
  36. - **State 3 — Full-Canvas Editorial Infographics (No Speaker)**:
  37. - Takes over the entire `#F3F0E8` canvas for deep conceptual breakdowns:
  38. - Side-by-side 2-column contrast layouts (deep charcoal `#141412` vs stacked sand/blush columns).
  39. - Side-by-side parallel coordinate charts (e.g. Linear Myth vs. Logarithmic Reality) and global comparisons.
  40. ### 2. Editorial & Tactile Visual Components (`motion_library/paper_objects.py`)
  41. - **Micro-Provenance Citations & Academic Notebook Cutoffs**: Single-line editorial citations pinned safely at `y=156` alongside classic torn ruled notebook slips with faint blue-gray rules and Scotch tape.
  42. - **Layered Stack Plates & Callouts**: Staggered tactile plates with strikethrough and terracotta coral (`#CC5A43`) focal transitions.
  43. - **Archival Serif Quote Sheets**: Off-white Georgia Serif document pages with acoustic-synced coral-blush (`#E8C6BC`) highlighter sweeps.
  44. - **Benchmark Charts, Sliders & Physical Objects**: Horizontal bar charts with dashed reference lines, horizontal label-switch sliders, hanging cream tags on strings with gold eyelets, 3D coin stacks, and dimensional arrows.
  45. ---
  46. ## Autonomous Execution Rules
  47. - **Zero Mid-Process Questions**: Never pause to ask clarifying questions, solicit confirmation, or request manual inputs during editing. Start immediately and execute all steps end-to-end.
  48. - **Auto Language Determination**:
  49. - If `/edit-reel <lang>` or `/reel <lang>` is given, use that language code (e.g. `en`, `es`, `zh`, `hi`, `ar`, `fr`, `pt`, `de`, `ja`, `darija`).
  50. - If triggered without language, default directly to `en`.
  51. - **Reference Script Ground-Truth Workflow**:
  52. - **Auto-Discovery**: Ingests companion script files (`<video_stem>.txt`, `.md`, `.docx`, `script.txt`) as ground-truth for subtitles, equations, and technical spelling.
  53. - **Script-Guided Forced Alignment**: Aligns exact script words to acoustic timestamps via time-constrained monotonic anchors.
  54. - **Intelligent Silence, Stumble & Repeated-Word Cutter (`detect_cuts.py`)**:
  55. - Uses `faster-whisper` (`word_timestamps=True`) to protect every valid spoken syllable.
  56. - Excises stumbles, false starts, and repeated takes.
  57. - **Anti-Arm-Reach Cutoff**: Identifies the calm frame after the last spoken word and stops cleanly before the speaker reaches out to turn off the camera.
  58. - **Natural Camera Exposure & Skin Tone Grading**:
  59. - Eliminates over-white highlight blowout from 10-bit Apple HLG / BT.2020 camera footage with gentle gamma compression and selective color balance.
  60. - Standard SDR tonemapping and reddish-warmth filter chain:
  61. `scale=1080:1920:force_original_aspect_ratio=increase,crop=1080:1920,eq=gamma=0.85:contrast=0.95:brightness=-0.035:saturation=1.02,colorbalance=rh=0.04:gh=-0.02:bh=-0.03:rm=0.03:gm=-0.01:bm=-0.02:pl=1,unsharp=5:5:0.25:5:5:0.10`
  62. - Yields rich, healthy, reddish hemoglobin glow (R ~ 124, G ~ 108, B ~ 96) with zero blown-out pixels above 248.
  63. - **Safe Layout Geometry & Zero-Overlap Guarantee**:
  64. - Safe mobile Reels/TikTok top margin buffer: `y = 0..158` (leaves room for search bar, camera notch, and audio pills).
  65. - Reference academic notebook cutoffs strictly anchored at `NOTE_Y_SPEAKER = 230` (`y = 158..302`).
  66. - Secondary tactile objects, chips, and curve plots placed in `y = 315..620` with zero overlap.
  67. - Speaker cutout active at `y >= 680..720`.
  68. - All chip and notebook bounding boxes (`label_chip`, `notebook_cutoff`) auto-expand dynamically with at least 32px safe horizontal padding, mathematically guaranteeing zero text clipping.
  69. - **Natural Broadcast Audio Mastering & Room Hiss Suppression**:
  70. - Strict prohibition against heavy FFT spectral noise cancellation (`afftdn=nr=24`) and aggressive downward gates (`agate`), which cause watery phase artifacts and hollow barrel resonance.
  71. - Clean, transparent broadcast vocal chain with gentle, smooth hiss reduction (`afftdn=nr=10:nf=-52:tn=1:gs=5`) and `lowpass=f=14000`:
  72. `highpass=f=75,lowpass=f=14000,afftdn=nr=10:nf=-52:tn=1:gs=5,equalizer=f=220:t=q:w=1.0:g=-1.0,equalizer=f=3800:t=q:w=1.0:g=1.5,acompressor=threshold=-18dB:ratio=2.2:attack=15:release=100:makeup=2.0dB,loudnorm=I=-11.5:LRA=6.0:TP=-0.5`
  73. - Drops room preamp hiss during pauses from -45 dB to -51 dB while preserving full vocal tone and chest resonance mastered to **-11.5 LUFS**.
  74. - **Background Music**: Warm ambient music bed (`ambient_bed.wav`) low-passed at `850 Hz` at `volume=0.045`.
  75. - **Keyframe-Locked SFX**: Micro-accents (`0.036..0.048` volume) synchronized to object reveal milestones (`paper_turn.wav`, `cash_chime.wav`, `tech_tick.wav`, `subtle_whoosh.wav`).
  76. - **Automated Output Naming & Summary Export (`pipeline.py`)**:
  77. - Automatically exports cleanly titled MP4 filenames (e.g., `Reel_<Title>_<Lang>.mp4`) alongside per-reel `<Video_Stem>_summary_and_titles.txt` and cumulative `reels_summary_and_titles.txt` inside `edited_output/`.
  78. - **100% Subscription-Free Tooling**:
  79. - Uses local open-source tools only (`faster-whisper`, MediaPipe, FFmpeg, PIL, `yt-dlp`, `hyperframes`), zero paid cloud APIs or subscriptions.
  80. ---
  81. ## Directory Structure
  82. - **Raw recordings input folder**:
  83. ```text
  84. ~/Desktop/projects/reels_IG/
  85. ```
  86. - **Motion assets & sound effects**:
  87. ```text
  88. ~/.gemini/config/skills/edit-reel/motion_library/sfx/
  89. ~/.gemini/config/skills/edit-reel/models/selfie_segmenter.tflite
  90. ```
  91. - **Processed production reels output folder**:
  92. ```text
  93. ~/Desktop/projects/reels_IG/edited_output/
  94. ```
  95. ---
  96. ## Autonomous Execution Commands
  97. ### Full Pipeline Run (English):
  98. ```bash
  99. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  100. ~/.gemini/config/skills/edit-reel/scripts/pipeline.py \
  101. --input-folder ~/Desktop/projects/reels_IG \
  102. --output-dir ~/Desktop/projects/reels_IG/edited_output \
  103. --lang en
  104. ```
  105. ### Full Pipeline Run (Spanish / Arabic / French / German):
  106. ```bash
  107. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  108. ~/.gemini/config/skills/edit-reel/scripts/pipeline.py \
  109. --input-folder ~/Desktop/projects/reels_IG \
  110. --output-dir ~/Desktop/projects/reels_IG/edited_output \
  111. --lang es
  112. ```
  113. ### Video with Companion Script:
  114. ```bash
  115. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  116. ~/.gemini/config/skills/edit-reel/scripts/pipeline.py \
  117. -i ~/Desktop/projects/reels_IG/sample_video.MP4 \
  118. -s ~/Desktop/projects/reels_IG/script.docx \
  119. --output-dir ~/Desktop/projects/reels_IG/edited_output \
  120. --lang en
  121. ```
  122. ### Direct Master Renderer (Instant Execution):
  123. ```bash
  124. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  125. ~/.gemini/config/skills/edit-reel/scripts/render_reel.py
  126. ```
  127. ### Preview All Scene Stills & Contact Sheet:
  128. ```bash
  129. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  130. ~/.gemini/config/skills/edit-reel/scripts/preview_reel_stills.py /tmp/reel_previews
  131. ```
  132. ### Download Reference Media & B-Roll (yt-dlp):
  133. ```bash
  134. # Download reference video / viral clip
  135. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  136. ~/.gemini/config/skills/edit-reel/scripts/download_ref.py "https://youtube.com/watch?v=..." -n ref_broll
  137. # Download and trim specific scene
  138. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  139. ~/.gemini/config/skills/edit-reel/scripts/download_ref.py "https://youtube.com/watch?v=..." -s 00:01:10 -e 00:01:25 -n broll_clip
  140. # Download audio only (WAV)
  141. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  142. ~/.gemini/config/skills/edit-reel/scripts/download_ref.py "https://..." --audio-only -n reference_audio
  143. ```
  144. ### Secondary Design & Framing Options (`--design`, `--speaker-style`, `--subtitle-style`, `--no-hook-stamp`):
  145. ```bash
  146. # Default (Editorial Paper + 3D Pop-Out Speaker Card + All Editorial Tricks):
  147. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  148. ~/.gemini/config/skills/edit-reel/scripts/pipeline.py \
  149. -i ~/Desktop/projects/reels_IG/raw_video.MP4 \
  150. --lang darija
  151. # Classic Paper Mode (Original warm #E2DDD1 kraft + full torso cutout + bold-stroke captions):
  152. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  153. ~/.gemini/config/skills/edit-reel/scripts/pipeline.py \
  154. -i ~/Desktop/projects/reels_IG/raw_video.MP4 \
  155. --design classic-paper --subtitle-style bold-stroke
  156. # Editorial Paper with Classic Cutout Torso (mix & match framing styles):
  157. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  158. ~/.gemini/config/skills/edit-reel/scripts/pipeline.py \
  159. -i ~/Desktop/projects/reels_IG/raw_video.MP4 \
  160. --design paper --speaker-style cutout --no-hook-stamp
  161. # Obsidian Glass & HyperFrames Mode (Secondary dark tech studio aesthetic):
  162. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  163. ~/.gemini/config/skills/edit-reel/scripts/pipeline.py \
  164. --input-folder ~/Desktop/projects/reels_IG \
  165. --output-dir ~/Desktop/projects/reels_IG/edited_output \
  166. --lang darija \
  167. --design glass
  168. # HyperFrames Standalone Card Scaffolding & Rendering:
  169. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  170. ~/.gemini/config/skills/edit-reel/scripts/hyperframes_engine.py init stat_card -d 6
  171. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  172. ~/.gemini/config/skills/edit-reel/scripts/hyperframes_engine.py render ~/Desktop/projects/reels_IG/motion_hyperframes/stat_card
  173. ~/.gemini/config/skills/edit-reel/.venv/bin/python3 \
  174. ~/.gemini/config/skills/edit-reel/scripts/hyperframes_engine.py render ~/Desktop/projects/reels_IG/motion_hyperframes/stat_card --transparent
  175. ```
  176. #### Available Options Summary
  177. - `--design {paper, classic-paper, glass}`:
  178. - `paper` *(default)*: Warm alabaster `#F3F0E8`, terracotta `#CC5A43` focal accents, `popout` rounded speaker card, micro-provenance eyebrow header, and generic data-driven storytelling templates (`layered_stack`, `quote_excerpt`, `benchmark_bars`, `label_slider`, `two_col_compare`).
  179. - `classic-paper`: Restores original `#E2DDD1` warm kraft paper, full-body MediaPipe cutout (`cutout`), and torn notebook citations without rounded card frame.
  180. - `glass`: Dark obsidian studio gradient with frosted HyperFrames glassmorphic cards.
  181. - `--speaker-style {auto, popout, cutout}`: Switch between **3D Pop-Out Floating Card** (`popout`, protects hand gestures) and **Full Body Cutout** (`cutout`).
  182. - `--subtitle-style {editorial, bold-stroke}`: Switch between crisp soft-shadow editorial text and classic thick dark outline captions.
  183. - `--no-hook-stamp`: Disables the State 1 top-of-head opening typographic badge + title stamp.
  184. ---
  185. ## Packaging & Sharing this Skill
  186. The entire self-contained skill is located at:
  187. ```text
  188. ~/.gemini/config/skills/edit-reel/
  189. ```
  190. To share it with a colleague or transfer to another workstation:
  191. 1. **Archive the skill directory** (excluding `.venv` and cache):
  192. ```bash
  193. tar -czf edit-reel-skill.tar.gz -C ~/.gemini/config/skills/edit-reel --exclude=".venv" --exclude=".reel_cache*" .
  194. ```
  195. 2. **On the target machine**, extract into the skills directory:
  196. ```bash
  197. mkdir -p ~/.gemini/config/skills/edit-reel
  198. tar -xzf edit-reel-skill.tar.gz -C ~/.gemini/config/skills/edit-reel
  199. python3 -m venv ~/.gemini/config/skills/edit-reel/.venv
  200. ~/.gemini/config/skills/edit-reel/.venv/bin/pip install -r ~/.gemini/config/skills/edit-reel/requirements.txt
  201. ```
README.md · README · 521 lines · 2 findings marked
  1. <div align="center">
  2. # edit-reel: Open-Source AI Video Editor & Auto Subtitles Generator
  3. ### Autonomous Short-Form Video Editing Agent for Instagram Reels, TikTok, and YouTube Shorts
  4. **Signature Tactile "Paper and Objects" Motion Graphics Engine for Claude Code, Cursor, Codex, and Google Antigravity**
  5. <p align="center">
  6. <b>English</b> |
  7. <a href="#multilingual-support">Español</a> |
  8. <a href="#multilingual-support">العربية</a> |
  9. <a href="#multilingual-support">中文</a> |
  10. <a href="#multilingual-support">Français</a> |
  11. <a href="#multilingual-support">Deutsch</a> |
  12. <a href="#multilingual-support">Português</a> |
  13. <a href="#multilingual-support">日本語</a>
  14. </p>
  15. [![GitHub Release](https://img.shields.io/github/v/release/MMhaidra/edit-reel?style=flat-square&color=2563EB&label=Release)](https://github.com/MMhaidra/edit-reel/releases/latest)
  16. [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/MMhaidra/edit-reel/blob/main/demo.ipynb)
  17. [![CI](https://github.com/MMhaidra/edit-reel/actions/workflows/ci.yml/badge.svg)](https://github.com/MMhaidra/edit-reel/actions)
  18. [![Package](https://img.shields.io/badge/Package-pip%20install-10B981.svg?style=flat-square)](https://github.com/MMhaidra/edit-reel#packages)
  19. [![GitHub Stars](https://img.shields.io/github/stars/MMhaidra/edit-reel?style=flat-square&color=blue)](https://github.com/MMhaidra/edit-reel/stargazers)
  20. [![Discussions](https://img.shields.io/badge/Discussions-Join-blueviolet?style=flat-square)](https://github.com/MMhaidra/edit-reel/discussions)
  21. [![License: MIT](https://img.shields.io/badge/License-MIT-F59E0B.svg?style=flat-square)](https://opensource.org/licenses/MIT)
  22. [![Python 3.9+](https://img.shields.io/badge/Python-3.9+-3B82F6.svg?style=flat-square)](https://www.python.org/downloads/)
  23. [![MediaPipe](https://img.shields.io/badge/Vision-MediaPipe-EA580C.svg?style=flat-square)](https://developers.google.com/mediapipe)
  24. [![FFmpeg Mastered](https://img.shields.io/badge/Audio%2FVideo-FFmpeg-15803D.svg?style=flat-square)](https://ffmpeg.org/)
  25. [![Google Antigravity](https://img.shields.io/badge/Skill-Google%20Antigravity-4285F4.svg?style=flat-square)](https://github.com/MMhaidra/edit-reel)
  26. [![Claude Code](https://img.shields.io/badge/Agent-Claude%20Code-D97706.svg?style=flat-square)](https://claude.ai)
  27. [![Cursor Ready](https://img.shields.io/badge/IDE-Cursor%20Ready-000000.svg?style=flat-square)](https://cursor.com)
  28. [![Share on X](https://img.shields.io/badge/Share_on_X-000000?style=flat-square&logo=x&logoColor=white)](https://twitter.com/intent/tweet?text=edit-reel%3A%20Autonomous%20Open-Source%20AI%20Video%20Editor%20for%20Reels%2C%20TikTok%20%26%20Shorts!%20Check%20it%20out%3A%20https%3A%2F%2Fgithub.com%2FMMhaidra%2Fedit-reel)
  29. <p align="center">
  30. <a href="#try-without-installation-google-colab">Try in Colab</a> |
  31. <a href="#problem-and-solution">Problem and Solution</a> |
  32. <a href="#quickstart-30-seconds">Quickstart</a> |
  33. <a href="#agentic-install">Agentic Install</a> |
  34. <a href="#feature-matrix">Feature Matrix</a> |
  35. <a href="#releases">Releases</a> |
  36. <a href="#packages">Packages</a> |
  37. <a href="#aesthetic-engine">Aesthetic Engine</a> |
  38. <a href="#multilingual-support">Multilingual Support</a> |
  39. <a href="#universal-scene-blueprint">Scene Blueprint</a> |
  40. <a href="#audio-mastering-suite">Audio Suite</a> |
  41. <a href="#frequently-asked-questions-faq">FAQ</a> |
  42. <a href="#star-history">Star History</a>
  43. </p>
  44. ---
  45. </div>
  46. <p align="center">
  47. <img src="assets/pipeline_flow.gif" alt="edit-reel Open-Source AI Video Editor and Auto Subtitles Pipeline Flowchart" width="100%" style="border-radius: 12px; box-shadow: 0 8px 30px rgba(0,0,0,0.35);" />
  48. </p>
  49. ## Problem and Solution
  50. **edit-reel** is a free, local-first, **open-source AI video editor** and **auto subtitles generator** built in Python for automated **short-form video production** (Instagram Reels, TikTok, and YouTube Shorts). It operates both as a standalone CLI tool and as a native **AI video editing agent skill** for **Claude Code**, **Cursor**, **Windsurf**, **OpenAI Codex**, and **Google Antigravity**.
  51. Vertical short-form video commands hundreds of billions of daily views worldwide, yet editing educational, technical, scientific, or business talking-head videos by hand requires hours of manual rotoscoping, silence cutting, keyframing, and audio mastering. Meanwhile, commercial cloud clippers and generic AI video generators produce watermarked videos cluttered with neon subtitle boxes or floating web-cards that look artificial and trigger immediate viewer swipe-away.
  52. Serving as a local-first, no-watermark **open-source alternative to CapCut, Submagic, Descript, OpusClip, and Veed.io**, **edit-reel** introduces an autonomous, zero-interaction editorial pipeline powered by Faster-Whisper, MediaPipe AI Vision, and FFmpeg using the signature tactile **"Paper and Objects"** aesthetic:
  53. - **Warm Textured Canvas**: Natural cream paper backdrop (`#E2DDD1`) with organic paper grain.
  54. - **Tangible Physical Primitives**: Hanging cream price tags with brass eyelets, 3D multi-tier coin stacks, and dimensional arrows.
  55. - **Dynamic Numerical Odometers**: Smooth rolling counters that visually build up to numerical milestones before stamping a conclusion.
  56. - **Academic Notebook Cutoffs**: Authentic ruled notebook slips with red margin lines, torn bottom edges, and Scotch tape for peer-reviewed citations.
  57. - **Parallel Coordinate Plots**: Clear side-by-side comparative graphs (such as Linear Myth vs. Logarithmic Reality).
  58. - **Speech-Protected Silence Removal & Auto Subtitles**: Millisecond-accurate Whisper word-boundary preservation, automatic filler-word and retake cutting, kinetic word-by-word animated captions, and anti-arm-reach tail cutoff.
  59. - **Broadcast Audio Mastering**: -11.5 LUFS mastered dialogue with spectral noise suppression, highpass gating, ambient bed ducking, and motion-locked micro-SFX.
  60. ---
  61. ## Quickstart (30 Seconds)
  62. ### 1. One-Line Universal Install
  63. ```bash
  64. curl -fsSL https://raw.githubusercontent.com/MMhaidra/edit-reel/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 79 on GitHub
  65. ```
  66. The script configures a virtual environment, installs vision and acoustic alignment dependencies, and symlinks the skill into your agentic IDEs.
  67. ### 2. Manual Setup
  68. ```bash
  69. git clone https://github.com/MMhaidra/edit-reel.git
  70. cd edit-reel
  71. python3 -m venv .venv
  72. source .venv/bin/activate
  73. pip install -r requirements.txt
  74. # Ensure FFmpeg is available
  75. # macOS:
  76. brew install ffmpeg
  77. # Ubuntu / Debian:
  78. sudo apt-get install -y ffmpeg
  79. ```
  80. ### 3. Run Pipeline on Video
  81. ```bash
  82. python scripts/pipeline.py \
  83. -i ~/Desktop/projects/reels_IG/raw_footage.mp4 \
  84. -s ~/Desktop/projects/reels_IG/script.docx \
  85. -o ~/Desktop/projects/reels_IG/edited_output \
  86. --lang en
  87. ```
  88. ### 4. Preview Scene Stills
  89. ```bash
  90. python scripts/preview_reel_stills.py /tmp/reel_previews
  91. ```
  92. ---
  93. ## Try Without Installation (Google Colab)
  94. You can run and test edit-reel entirely in the cloud without installing Python or FFmpeg on your machine:
  95. [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/MMhaidra/edit-reel/blob/main/demo.ipynb)
  96. The interactive notebook walks through:
  97. - Automated Faster-Whisper acoustic extraction
  98. - MediaPipe person segmentation on warm paper canvas
  99. - Physical objects rendering (hanging tags, 3D coins, and notebook citations)
  100. - Broadcast audio mastering preview
  101. ---
  102. ## Agentic Install
  103. edit-reel is natively structured for autonomous AI coding agents:
  104. ### Install Prompt for AI Agents
  105. Paste this single line into **Claude Code**, **ChatGPT Desktop**, or **Cursor**:
  106. ```text
  107. Install the /edit-reel skill globally from https://github.com/MMhaidra/edit-reel
  108. ```
  109. ### Google Antigravity
  110. The skill is defined in `SKILL.md` and registered at `~/.gemini/config/skills/edit-reel/`.
  111. Trigger in conversation:
  112. ```text
  113. /edit-reel en
  114. /edit-reel es
  115. /edit-reel ar
  116. ```
  117. Antigravity scans your recordings directory (`~/Desktop/projects/reels_IG/`), matches companion scripts, trims dead air, generates physical graphics, masters audio, and delivers the finished MP4 with zero mid-process interruptions.
  118. ### Claude Code
  119. The repository provides [`CLAUDE.md`](CLAUDE.md) for terminal execution:
  120. ```bash
  121. claude
  122. > "Run edit-reel pipeline on my raw video in ~/Desktop/projects/reels_IG"
  123. ```
  124. ### Cursor and Windsurf
  125. The repository includes [`.cursorrules`](.cursorrules) configuring code style, safe margins, and testing commands.
  126. ---
  127. ## Feature Matrix
  128. | Feature | edit-reel (Open-Source) | Commercial Cloud AI Editors (Submagic / Veed / OpusClip) | Manual Video Editing (Premiere / CapCut / DaVinci) |
  129. |:---|:---:|:---:|:---:|
  130. | **Zero User Interaction During Run** | Yes (100% Autonomous) | No (requires manual web UI clicks) | No (hours of manual timeline labor) |
  131. | **Visual Aesthetic** | Tactile Paper and Physical Objects | Neon web-cards / generic templates | Custom (labor-intensive) |
  132. | **AI Background Removal** | Local MediaPipe AI (`selfie_segmenter`) | Paid cloud chromakey or None | Manual Rotoscoping / Masking |
  133. | **Auto Subtitles & Kinetic Captions** | Word-level Faster-Whisper forced alignment | Cloud ASR (often drifts on technical terms) | Manual caption correction |
  134. | **Academic Notebook Citations** | Ruled slips with Scotch tape | Plain text boxes | Manual graphic design |
  135. | **Rolling Numerical Odometers** | Physics-based ease counters | Static text | After Effects expression rigging |
  136. | **Speech-Protected Silence Cutting** | Whisper word-level boundary locks | Hard silence decibel cuts | Manual waveform slicing |
  137. | **Anti-Arm-Reach Cutoff** | Automatic post-speech hold | None (speaker reaches to lens) | Manual clip trimming |
  138. | **Broadcast Audio Mastering** | -11.5 LUFS vocal chain + ambient bed | Raw microphone audio | Multi-plugin DAW mastering |
  139. | **Multilingual Support** | 12+ languages (Latin, RTL, CJK) | Limited or paid tier | Dependent on editor |
  140. | **Cost & Watermarks** | 100% Free, Local-First, No Watermark | Monthly SaaS subscription / Watermarked | Software license + high time cost |
  141. ---
  142. ## Releases
  143. Official production releases and downloadable archives:
  144. - **Latest Stable Release**: [v1.0.0](https://github.com/MMhaidra/edit-reel/releases/tag/v1.0.0)
  145. - **Source Code (tar.gz)**: [edit-reel-1.0.0.tar.gz](https://github.com/MMhaidra/edit-reel/archive/refs/tags/v1.0.0.tar.gz)
  146. - **Source Code (zip)**: [edit-reel-1.0.0.zip](https://github.com/MMhaidra/edit-reel/archive/refs/tags/v1.0.0.zip)
  147. To download and extract the release:
  148. ```bash
  149. curl -fsSL https://github.com/MMhaidra/edit-reel/archive/refs/tags/v1.0.0.tar.gz | tar -xz
  150. cd edit-reel-1.0.0
  151. ```
  152. ---
  153. ## Packages
  154. ### Direct Install via pip (GitHub)
  155. ```bash
  156. pip install git+https://github.com/MMhaidra/edit-reel.git
  157. ```
  158. ### Editable Developer Install
  159. ```bash
  160. git clone https://github.com/MMhaidra/edit-reel.git
  161. cd edit-reel
  162. pip install -e .
  163. ```
  164. After installation, the CLI command `edit-reel` is globally available:
  165. ```bash
  166. edit-reel -i raw_video.mp4 -o ./output --lang en
  167. ```
  168. ---
  169. ## Universal Scene Blueprint
  170. The rendering engine follows an 8-scene editorial blueprint designed to maintain engagement across 45-to-90 second reels:
  171. | Scene | Editorial Purpose | Visual State | Graphic Primitives | Audio Milestone |
  172. |:---:|:---|:---:|:---|:---:|
  173. | **1** | Problem Statement / Direct Hook | Real Camera Studio | 1.04x camera punch-in on alternating sentences | Crisp voice, ambient bed introduction |
  174. | **2** | Critical Number / Pivot Metric | Lowered Cutout on Paper | Hanging cream tag with string and rolling odometer | Clean pop, cash chime SFX |
  175. | **3** | Acceleration / Upward Trajectory | Lowered Cutout on Paper | 3D coin stack, dimensional directional arrow | Paper turn SFX |
  176. | **4** | Comparative Breakdown (Myth vs. Reality) | Full-Screen Infographic | Dual parallel coordinate plots | Subtle whoosh SFX |
  177. | **5** | Empirical Evidence / Study Citation | Lowered Cutout on Paper | Ruled notebook paper cutoff with Scotch tape | Tech tick SFX |
  178. | **6** | Global Context / Entity Rankings | Full-Screen Infographic | Circular entity badges and distribution ranks | Subtle whoosh SFX |
  179. | **7** | Counter-Intuitive Truth / Metric Contrast | Lowered Cutout on Paper | Split bar comparison, contrast cards | Tech tick SFX |
  180. | **8** | Strategic Takeaway / Actionable Synthesis | Lowered Cutout on Paper | Triple rounded icon chips and takeaway card | Clean pop, outro bed |
  181. ---
  182. ## Multilingual Support
  183. edit-reel provides native speech-protected transcription, acoustic alignment, and typographic rendering across worldwide languages:
  184. | Language | ISO Code | Script Family | Subtitle Typography | Ground-Truth Citation Handling |
  185. |:---|:---:|:---:|:---|:---|
  186. | **English** | `en` | Latin | Bold Sans-Serif (`#FFFFFF` with `#000000` shadow) | Technical spelling and formulas preserved |
  187. | **Spanish** | `es` | Latin | Bold Sans-Serif | Academic titles and journal citations preserved |
  188. | **Mandarin Chinese** | `zh` | Simplified / Traditional | PingFang SC / Noto Sans CJK | Automatic CJK character tokenization |
  189. | **Hindi** | `hi` | Devanagari | Devanagari MT / Noto Sans Devanagari | Conjunct ligature and matra support |
  190. | **Arabic** | `ar` | Arabic (RTL) | Al Bayan / Geeza Pro / Naskh | Monotonic right-to-left word highlighting |
  191. | **French** | `fr` | Latin | Bold Sans-Serif | Accent-preserved phonetics |
  192. | **Portuguese** | `pt` | Latin | Bold Sans-Serif | Brazilian and European Portuguese phonetics |
  193. | **German** | `de` | Latin | Bold Sans-Serif | Compound noun protection during speech cuts |
  194. | **Japanese** | `ja` | Kanji / Kana | Hiragino Sans / Noto Sans JP | Boundary-aware acoustic alignment |
  195. | **Italian** | `it` | Latin | Bold Sans-Serif | Latin typographic layout |
  196. | **Russian** | `ru` | Cyrillic | Arial Bold / Helvetica Cyrillic | Cyrillic character set support |
  197. | **Korean** | `ko` | Hangul | AppleGothic / Noto Sans KR | Syllable-block acoustic synchronization |
  198. | **Regional Dialects** | `ary`, `darija` | Arabic / Arabizi | Naskh / Latin | Phonetic Darija alignment with English citations |
  199. Run with your target language:
  200. ```bash
  201. python scripts/pipeline.py -i video.mp4 --lang es
  202. python scripts/pipeline.py -i video.mp4 --lang zh
  203. python scripts/pipeline.py -i video.mp4 --lang ar
  204. ```
  205. ---
  206. ## Aesthetic Engine
  207. ```text
  208. 3-STATE ALTERNATING VISUAL RHYTHM
  209. -------------------------------------------------------------
  210. State 1: REAL CAMERA STUDIO (Camera A/B)
  211. - Authentic studio background preserved for hook and pauses
  212. - 1.04x punch-in zooms on sentence transitions for retention
  213. State 2: LOWERED CUTOUT SPEAKER + PHYSICAL OBJECTS
  214. - MediaPipe AI segmentation (selfie_segmenter.tflite)
  215. - Speaker positioned on warm paper canvas (y = 800..1920)
  216. - Upper canvas displays hanging tags, counters, and coin stacks
  217. State 3: FULL-SCREEN INFOGRAPHIC
  218. - Side-by-side comparative plots (Linear vs. Logarithmic)
  219. - Academic notebook cutoffs with ruled lines and tape
  220. ```
  221. ### 1. Tangible Physical Objects
  222. - **Hanging Price Tags**: Cream cards with angled corners, inner stroke border, and gold metal eyelet hanging from a string. Includes physics-based pendulum sway upon entry.
  223. - **Dynamic Loading Numbers**: Numerical milestones animate as rolling odometer counters.
  224. - **3D Coin Stacks**: Multi-tier gold coin stacks with rim bevels, accompanied by green (`#00704A`) up-arrows and red (`#BA1828`) down-arrows.
  225. - **Academic Notebook Cutoffs**: Authentic pinned notebook paper slips with ruled blue-gray lines (`#CBD5E1`), red vertical margin lines (`#F87171`), torn bottom edges, and semi-transparent top Scotch tape. Positioned lower down (`y = 165` on speaker scenes, `y = 210` on full-screen scenes) to safely clear mobile camera cutouts and platform status bars.
  226. - **Vector Icon Chips**: Rounded white label chips (`border-radius: 18px`) with high-resolution vector icons.
  227. ### 2. Speech-Protected Trimming and Anti-Arm-Reach Cutoff
  228. - `detect_cuts.py` leverages Faster-Whisper with word-level timestamps to protect every valid spoken syllable.
  229. - Automatically removes dead-air pauses, throat clears, stumbles, and repeated takes.
  230. - **Anti-Arm-Reach Cutoff**: Trims cleanly at the calm, smiling frame following the final word, eliminating the motion of the speaker reaching forward to turn off the camera.
  231. ---
  232. ## Audio Mastering Suite
  233. Every video rendered by edit-reel passes through an automated broadcast audio mastering chain:
  234. ```text
  235. Raw Microphone Audio
  236. |
  237. v
  238. FFT Spectral Denoiser (afftdn=nr=24:nf=-48:tn=1)
  239. |
  240. v
  241. Highpass Filter (85 Hz cutoff)
  242. |
  243. v
  244. Downward Expander Gate (agate, eliminates room hiss)
  245. |
  246. v
  247. Studio Vocal Compressor (attack=15ms, release=100ms)
  248. |
  249. v
  250. Broadcast Loudness Normalizer (loudnorm -> -11.5 LUFS)
  251. |
  252. v
  253. Ambient Music Bed Ducking (850 Hz low-pass at volume 0.045)
  254. |
  255. v
  256. Keyframe-Locked Micro-SFX (paper turns, pops, chimes at volume 0.04)
  257. |
  258. v
  259. Final Mastered Multi-Track Audio (.MP4)
  260. ```
  261. ---
  262. ## Pipeline Architecture
  263. The end-to-end autonomous pipeline continuously executes through six discrete stages visualized in the looping workflow flowchart at the top:
  264. | Stage | Module | Key Transformation |
  265. |:---:|:---|:---|
  266. | **01** | `detect_cuts.py` | Ingests raw video footage (.mp4/.mov) and companion script (.docx/.txt) |
  267. | **02** | `transcribe_align.py` | Extracts Whisper millisecond word timestamps and applies acoustic silence/stumble trimming |
  268. | **03** | `storyboard_planner.py` | Synthesizes an 8-scene beat map alternating between Studio, Cutout, and Infographic |
  269. | **04** | `paper_objects.py` | Isolates speaker with MediaPipe and composites hanging tags, odometers, and notebook citations |
  270. | **05** | `FFmpeg Vocal Chain` | Applies adaptive spectral denoising, 85Hz highpass gate, -11.5 LUFS loudness, and motion SFX |
  271. | **06** | `render_reel.py` | Exports the production-ready 1080x1920 9:16 vertical reel autonomously |
  272. ---
  273. ## Customization (Make It Yours)
  274. Brand styling, color palettes, and audio parameters can be customized via `templates/config.json`:
  275. ```json
  276. {
  277. "canvas": {
  278. "paper_color": "#E2DDD1",
  279. "ink_color": "#262320",
  280. "accent_green": "#00704A",
  281. "accent_red": "#BA1828"
  282. },
  283. "audio": {
  284. "target_lufs": -11.5,
  285. "bgm_volume": 0.045,
  286. "sfx_volume": 0.040,
  287. "bgm_lowpass_hz": 850
  288. },
  289. "safe_zones": {
  290. "speaker_y": 800,
  291. "notebook_speaker_y": 165,
  292. "notebook_fullscreen_y": 210,
  293. "subtitles_y": 1555
  294. }
  295. }
  296. ```
  297. ---
  298. ## Repository Structure
  299. ```text
  300. edit-reel/
  301. ├── SKILL.md # Antigravity and Claude Code skill definition
  302. ├── README.md # Public documentation and specifications
  303. ├── LICENSE # MIT License
  304. ├── requirements.txt # Python dependencies
  305. ├── pyproject.toml # Package metadata and CLI entry points
  306. ├── install.sh # Universal installer script
  307. ├── CLAUDE.md # Claude Code developer guide
  308. ├── .cursorrules # Cursor and Windsurf prompt rules
  309. ├── .gitignore # Git ignore rules
  310. ├── credit_ledger.example.json # Template for API token and cost tracking
  311. │
  312. ├── assets/ # Animated pipeline flowchart assets
  313. │ └── pipeline_flow.gif
  314. │
  315. ├── models/ # Bundled edge AI vision models
  316. │ ├── selfie_segmenter.tflite # Fast 244KB person segmentation model
  317. │ └── selfie_multiclass.tflite # High-precision multiclass model
  318. │
  319. ├── motion_library/ # Tangible physical objects and styling
  320. │ ├── paper_objects.py # Canonical objects (tags, odometers, coins, notebooks)
  321. │ ├── renderers.py # Motion renderers and canvas drawing
  322. │ ├── palette.py # Editorial color system (#E2DDD1, #00704A, #BA1828)
  323. │ ├── catalog.py # Metadata and object definitions
  324. │ ├── icons/ # Over 150+ vector icons across science, tech, and finance
  325. │ ├── broll/ # Curated ambient B-roll textures
  326. │ └── sfx/ # Mastered sound effects (pops, paper turns, chimes)
  327. │
  328. ├── references/ # Safe-zone specs and phonetic dictionaries
  329. │ ├── safe_zone_layout.md # 9:16 mobile safe zone boundaries
  330. │ ├── animation_catalog.md # Visual primitives reference
  331. │ └── darija_transcription.md # Phonetic Moroccan Darija dictionary
  332. │
  333. ├── scripts/ # Execution pipeline
  334. │ ├── pipeline.py # Master end-to-end pipeline runner
  335. │ ├── render_reel.py # Core video renderer and audio mixer
  336. │ ├── detect_cuts.py # Speech-protected silence and stumble trimmer
  337. │ ├── transcribe_align.py # Whisper forced aligner
  338. │ ├── storyboard_planner.py # 3-state scene scheduler
  339. │ ├── preview_reel_stills.py # Scene still and contact sheet previewer
  340. │ ├── generate_animated_flowchart.py# Looping pipeline GIF generator
  341. │ └── progress_tracker.py # Real-time terminal progress logger
  342. │
  343. └── templates/
  344. └── config.json # Production defaults
  345. ```
  346. ---
  347. ## Frequently Asked Questions (FAQ)
  348. <details open>
  349. <summary><b>What is the best free open-source AI video editor for Instagram Reels, TikTok, and YouTube Shorts?</b></summary>
  350. <br>
  351. **edit-reel** is a 100% free, MIT-licensed open-source AI video editor written in Python that runs locally on macOS and Linux with zero watermarks. Unlike web-based SaaS clippers, it combines word-accurate Faster-Whisper speech trimming, MediaPipe AI person background segmentation, tactile physical motion graphics, and -11.5 LUFS broadcast audio mastering in a single command.
  352. </details>
  353. <details>
  354. <summary><b>How do I automatically add animated subtitles and remove silences from talking-head videos in Python?</b></summary>
  355. <br>
  356. Run `python scripts/pipeline.py -i input.mp4 --lang en`. The pipeline executes `detect_cuts.py` to remove dead air, false starts, and stumbles while protecting spoken syllables, aligns your script to millisecond acoustic timestamps via `transcribe_align.py`, and burns word-by-word kinetic subtitles directly onto the 9:16 vertical canvas.
  357. </details>
  358. <details>
  359. <summary><b>How does edit-reel work as a Claude Code skill, Cursor rule, or Google Antigravity skill?</b></summary>
  360. <br>
  361. The repository includes native agent definitions (`SKILL.md`, `CLAUDE.md`, and `.cursorrules`). Running the one-line installer (`curl -fsSL https://raw.githubusercontent.com/MMhaidra/edit-reel/main/install.sh | bash`) registers the `/edit-reel` command globally so your AI coding agent can autonomously edit raw recordings from start to finish.
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 453 on GitHub
  362. </details>
  363. <details>
  364. <summary><b>Does edit-reel require Adobe After Effects, Premiere Pro, or paid cloud APIs?</b></summary>
  365. <br>
  366. No. All computer vision segmentation (`selfie_segmenter.tflite`), acoustic forced alignment (`faster-whisper`), procedural motion graphics (`Pillow` / `OpenCV`), and multi-track audio mastering (`FFmpeg`) execute locally on your machine at zero cost.
  367. </details>
  368. ---
  369. ## Star History
  370. If you find edit-reel useful for your content creation or agent workflows, please consider starring the repository to help other developers and creators discover it:
  371. <p align="center">
  372. <a href="https://star-history.com/#MMhaidra/edit-reel&Date">
  373. <img src="https://api.star-history.com/svg?repos=MMhaidra/edit-reel&type=Date" alt="edit-reel Star History Chart" width="100%" />
  374. </a>
  375. </p>
  376. ---
  377. ## Citation
  378. If you use edit-reel in your research, academic publications, or production frameworks, please cite it as follows:
  379. ```bibtex
  380. @software{mhaidra2026editreel,
  381. author = {Mhaidra, Mohammed},
  382. title = {edit-reel: Autonomous Open-Source AI Video Editor & Auto Subtitles Generator},
  383. year = {2026},
  384. url = {https://github.com/MMhaidra/edit-reel},
  385. version = {1.0.0}
  386. }
  387. ```
  388. ---
  389. ## Community and Launch Playbook
  390. Looking to share edit-reel with your community, submit to Awesome lists, or post a launch thread? Check out our complete guide:
  391. - [`docs/VIRAL_LAUNCH_PLAYBOOK.md`](docs/VIRAL_LAUNCH_PLAYBOOK.md): Ready-to-copy launch templates for Hacker News (Show HN), Reddit (`r/Python`, `r/LocalLLaMA`, `r/ClaudeAI`), Twitter/X launch threads, and curated directory PR submissions.
  392. ---
  393. ## Contributing
  394. Contributions, feature requests, and new motion primitives are welcome:
  395. 1. Fork the Project (`https://github.com/MMhaidra/edit-reel/fork`).
  396. 2. Create your Feature Branch (`git checkout -b feature/NewMotionPrimitive`).
  397. 3. Commit your Changes (`git commit -m 'feat: Add animated dual-gauge metric primitive'`).
  398. 4. Push to the Branch (`git push origin feature/NewMotionPrimitive`).
  399. 5. Open a Pull Request.
  400. ---
  401. ## License
  402. Distributed under the **MIT License**. See [`LICENSE`](LICENSE) for more information.
  403. ---
  404. <div align="center">
  405. <b>Author: <a href="https://github.com/MMhaidra">Mohammed Mhaidra</a></b>
  406. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.