⚡ Overview

Reelcraft is an intelligent AI Agent Skill and standalone CLI engine designed as a studio-grade, high-retention alternative to /brag. It transforms code repositories, technical launch posts, CLI tools, and architecture diagrams into cinematic, algorithmic 9:16 vertical videos (for Instagram Reels, TikTok, and YouTube Shorts) as well as 16:9 widescreen showcases.

Powered by Hyperframes, Reelcraft autonomously inspects your project to determine light/dark themes, extracts brand hex colors and vector logos, scripts a high-retention 4-beat storyboard, generates native studio narration, and outputs 1080×1920 60fps MP4 videos — complete with Frame-1 poster thumbnails, captions, and viral hashtags.

📐 Autonomous Video Generation Pipeline

flowchart TD
    subgraph IN["1. Raw Codebase & Product Input"]
        A["Local Repo / GitHub URL"] --> B["Theme & Asset Detection"]
        C["README / Launch Post"] --> B
        D["Architecture & CLI Schema"] --> B
    end

    subgraph ENGINE["2. Reelcraft Intelligence Engine"]
        B --> E["Brand Color & Logo Extractor"]
        B --> F["4-Beat Storyboard Scripting"]
        F --> G["Hook: 0-3s Curiosity Spike"]
        F --> H["Mechanism: How It Works"]
        F --> I["Interactive Demo: Code & UI"]
        F --> J["CTA: Payoff & GitHub Star"]
    end

    subgraph AUDIO["3. Studio Audio & Voiceover"]
        G & H & I & J --> K["Kokoro-82M / Edge-TTS Neural Voice"]
        K --> L["Beat-Synced Music & SFX Audio Cues"]
    end

    subgraph RENDER["4. 60fps Hyperframes Render Canvas"]
        E & L --> M["Headless Chromium 60fps Canvas"]
        M --> N["Sub-Frame Motion Graphics & Captions"]
        N --> O["Frame-1 High-CTR Poster JPG"]
        N --> P["1080x1920 9:16 Vertical MP4"]
    end

    style IN fill:#0d1117,stroke:#30363d,stroke-width:1px,color:#c9d1d9
    style ENGINE fill:#161b22,stroke:#8b5cf6,stroke-width:2px,color:#f0f6fc
    style AUDIO fill:#0d1117,stroke:#10b981,stroke-width:1px,color:#c9d1d9
    style RENDER fill:#161b22,stroke:#6366f1,stroke-width:2px,color:#f0f6fc

🎬 Real Rendered Video Showcase

Reelcraft includes 5 production-grade test suites with real, 100% rendered MP4 videos (H.264 + AAC audio) featuring AI narration, dynamic motion graphics, beat-synced tracks, and interactive UI sound design.

📱 Flagship 9:16 Vertical Reels

🎨 Brand Assets

All official Reelcraft media assets are available in high resolution under the assets/ directory:

| Asset | Preview | Dimensions | Format | Usage | |---|---|---|---|---| | 2K Master Banner | reelcraft-banner-2k.png | 2560 × 1440 (16:9) | PNG (RGB) | GitHub Hero, Product Hunt, Blog header | | 1080p Banner | reelcraft-banner-1080p.png | 1920 × 1080 (16:9) | PNG (RGB) | Standard 1080p displays, Twitter/X cards | | App Icon | logo.png | 1000 × 1000 (1:1) | PNG (RGBA) | Avatar, Favicon, Mobile App Icon | | Brand Lockup | reelcraft.png | 954 × 163 | PNG (RGBA) | Official wordmark header & lockup |

⚡ Quick Install

1. Universal AI Agent Skill (Antigravity, Claude Code, Cursor, Codex)

Install globally across your machine with the skills CLI:

# Global installation (recommended):
npx skills add -g https://github.com/dusmamud/reelcraft --skill reelcraft

# Or install inside a single project directory:
npx skills add https://github.com/dusmamud/reelcraft --skill reelcraft

2. Standalone CLI (Direct Terminal Execution)

No AI agent required — run and render reels directly via npm:

# Scaffold a new reel project:
npx reelcraft init my-reel

# Preview live in browser (zero render lag):
npx reelcraft preview my-reel

# Render to 1080p MP4 + poster thumbnail + captions:
npx reelcraft render my-reel

3. Claude Code Plugin Marketplace

/plugin marketplace add dusmamud/reelcraft
/plugin install reelcraft@reelcraft

🚀 How To Use

Inside any codebase, Git repository, or standalone folder, invoke your AI assistant:

/reelcraft

Steer the Creative Direction:

# Add studio AI narration (Kokoro-82M English default):
/reelcraft --voice

# Cyberpunk obsidian dark theme:
/reelcraft --tone cyberpunk --voice

# Native Hindi / Hinglish voiceover via Edge-TTS:
/reelcraft --voice --lang hindi

# Autonomous Topic Mode (No existing codebase needed!):
/reelcraft "Physical AI and Humanoid Robotics in 2026"

# Editorial paper aesthetic with 30s duration:
/reelcraft --tone paper-and-ink --format vertical --duration 30

Supported Flags:

| Flag | Values | Default | Description | |---|---|---|---| | --tone | luminous, paper-and-ink, cyberpunk, terminal-hacker, apple-minimal, unhinged | Auto-detected from project theme | Visual aesthetic and motion rhythm | | --format | vertical (1080×1920), landscape (1920×1080) | vertical | Native 9:16 mobile aspect ratio or 16:9 widescreen | | --duration | 15 to 30 (seconds) | 20s | Total video duration | | --voice | flag | off | Enables studio AI narration (kokoro or edge-tts) | | --lang | en (English), hi (Hindi/Hinglish) | en | Voiceover language engine | | --no-music| flag | off | Disables background soundtrack | | --no-sfx | flag | off | Disables UI sound effects suite (clicks, impacts, keystrokes) |

💻 CLI Commands

Reelcraft comes with a robust set of CLI commands. Here are real examples of running each command:

npx reelcraft --help

  Usage: reelcraft [options] [command]

  Turn any codebase, product, or topic into a high-retention 9:16 vertical viral video

  Options:
    -V, --version                   output the version number
    -h, --help                      display help for command

  Commands:
    init [name]                     Scaffold a new reel project
    preview [path]                  Launch instant live browser preview
    render [options] [path]         Render reel to 1080x1920 MP4 video
    lint [path]                     Fast static linting (<50ms)
    check [path]                    Full headless browser runtime check
    doctor                          Verify system dependencies and tools

npx reelcraft doctor

  Reelcraft Doctor - System Diagnostics:
  ✔ Node.js: v22.12.0
  ✔ HyperFrames CLI: available
  ✔ Python: 3.12.3
  ✔ Kokoro TTS: available
  ✔ Edge-TTS: available
  ✔ Chromium / Browser: available
  ✔ All checks passed! You are ready to craft reels.

🧠 Why Reelcraft Beats Screen Recordings

[0.0s – 3.5s]      [3.5s – 8.0s]        [8.0s – 18.0s]        [18.0s – 25.0s]
Pattern Interrupt ──> Problem Agitation ──> Tech Breakthrough ──> Viral Outro & CTA
(Swipe-Stopper)       (Legacy vs Future)   (Live Code Proof)     (Follow & Comment)

1. The 4-Beat Algorithmic Retention Curve: Social media algorithms harshly penalize videos that lose viewers in the first 3 seconds. Reelcraft enforces an algorithmic structure designed specifically for 85%+ completion rates.
2. 100% Mobile Safe-Zones: Strict CSS contracts (--safe-top: 140px; --safe-bottom: 280px; --safe-right: 160px;) guarantee typography is never covered by Instagram or TikTok like buttons, comment inputs, or audio tags.
3. Kinetic Typography & Spring Physics: Smooth cubic-bezier transitions (cubic-bezier(0.16, 1, 0.3, 1)), frosted glass panels, and ambient specular glows.
4. Sub-Frame Beat Syncing: Built-in audio cues detect BPM and downbeats, snapping card reveals and SFX impacts to the rhythm of the music.

📦 What Every Run Produces

Every run generates a self-contained, clean output package in reel-output/:

reel-output/
├── reel.mp4              # 1080x1920 30/60fps finished H.264+AAC MP4 video
├── poster.jpg            # High-contrast Frame-1 cover thumbnail
├── captions.txt          # Ready-to-publish social copy + 15 targeted hashtags
├── reel-plan.md          # 4-beat storyboard, timestamps & voiceover script
└── composition/          # Full HyperFrames HTML/CSS/JS source
    ├── index.html        # Kinetic animation source
    └── assets/           # Self-contained fonts, music, and sound effects

🛠️ Pre-Flight Linting & Diagnostics

Video rendering takes computing resources. Reelcraft catches 100% of audio and layout issues in 50 milliseconds before rendering starts:

# 1. Lint HTML tags and media IDs:
npx reelcraft lint reel-output/composition

# 2. Run full headless Chromium runtime & contrast check:
npx reelcraft check reel-output/composition

# 3. System environment health check:
npx reelcraft doctor

Complete Guides:

• 📖 docs/CLI.md — Comprehensive command-line reference and examples
• 🛠️ docs/INSTALLATION.md — Multi-agent setup for Antigravity, Claude Code, Cursor & NPM
• 🚨 docs/VALIDATION_AND_LINTING.md — 3-tier validation pipeline, error catalog, and fixes

📂 Repository Layout

E:\Tools\reelcraft/
├── assets/                        # Brand marks, icons, and 2K/1080p showcase banners
├── bin/reelcraft.js               # Standalone CLI entrypoint
├── docs/                          # GitHub Pages interactive landing site & documentation
├── examples/                      # Real-world benchmark project with finished MP4
├── scripts/                       # Voiceover, music analysis & validation scripts
├── skills/reelcraft/              # Core Agent Skill manifest & 7 reference guides
│   ├── references/                # Step-by-step pipeline, hook formulas, tone presets
│   └── assets/                    # Royalty-free music library and SFX suite
└── tests/                         # 5 production-grade test suites (01 to 05 with rendered MP4s)

🤝 Community, Security & Contributing

Reelcraft is an open-source project welcoming developers, designers, and AI creators worldwide:

• 🤝 CONTRIBUTING.md — Guide on reporting bugs, requesting features, submitting pull requests, and setting up local development.
• 🛡️ SECURITY.md — Security policies, supported versions, and responsible vulnerability disclosure process.
• 📜 CODE_OF_CONDUCT.md — Contributor Covenant pledge and community standards.
• 💬 SUPPORT.md — Where to get help, community discussions, and troubleshooting guides.

👤 Author & Repository

Dus Mamud

• GitHub: @dusmamud
• Repository: https://github.com/dusmamud/reelcraft
• Email: [email protected]

📄 License

Released under the MIT License • Built for the modern AI and developer community.