What Is the Purpose of the index.js File in bradautomates/claude-video?

The bradautomates/claude-video repository contains no index.js file because it is implemented entirely in Python as a video analysis skill for Claude agents.

The bradautomates/claude-video project is a pure-Python package that implements the watch skill for Claude-based agents, enabling AI systems to download, frame-extract, and transcribe video content. When investigating the purpose of an index.js file in this codebase, you will find that none exists—the architecture relies exclusively on Python scripts to orchestrate video processing workflows. The repository leverages tools like yt-dlp, ffmpeg, and the Whisper API, which operate within the Python ecosystem rather than Node.js.

Why There Is No index.js File in claude-video

The repository structure confirms this is a Python-only project. A glob search for **/*.js returns no results, and the source tree contains no Node.js configuration files such as package.json or node_modules/.

The project implements the watch skill, which requires Python-centric dependencies for video processing. These include:

• yt-dlp for downloading video streams from URLs
• ffmpeg for extracting frames at specified intervals
• Whisper API for audio transcription and caption generation

Because these tools are inherently Python-based, a JavaScript entry point would serve no functional purpose in this architecture.

Actual Entry Points and Architecture

Rather than an index.js file acting as a JavaScript entry point, the repository uses a modular Python architecture with specific orchestration scripts located under skills/watch/scripts/.

The Primary Entry Point: watch.py

The central execution logic resides in skills/watch/scripts/watch.py. This script coordinates the complete video processing pipeline:

1. Downloads video content via download.py
2. Extracts representative frames through frames.py
3. Generates transcripts using transcribe.py

According to the skill definition in skills/watch/SKILL.md, this Python file serves as the canonical entry point when the /watch command is invoked by a Claude agent or compatible host environment.

Supporting Scripts in skills/watch/scripts/

The repository organizes functionality into specialized modules within the skills/watch/scripts/ directory:

• download.py – Wraps yt-dlp to fetch video files from URLs and handle caching
• frames.py – Interfaces with ffmpeg to extract frames at calculated FPS intervals
• transcribe.py – Handles caption extraction and OpenAI Whisper API transcription
• whisper.py – Provides additional audio processing utilities and format conversion
• config.py – Manages environment variables and skill configuration
• setup.py – Validates dependencies and initializes the skill environment

How to Install and Run the Skill

Since there is no index.js or Node.js runtime component, you interact with this repository through Python interpreters or skill CLI commands.

Install the skill using the Agent Skills CLI:

npx skills add bradautomates/claude-video -g

Invoke the watch command from a supported host:

/watch https://www.youtube.com/watch?v=example "What is happening at 00:45?"

Alternatively, run the Python entry point directly to process local or remote videos:

python -m skills.watch.scripts.watch https://example.com/video.mp4

Summary

• The bradautomates/claude-video repository contains no index.js file and no JavaScript code whatsoever
• The project is a pure-Python implementation of a video analysis skill for Claude agents
• The actual entry point is skills/watch/scripts/watch.py, which orchestrates the download, frame extraction, and transcription pipeline
• Supporting modules in skills/watch/scripts/ handle specific tasks using yt-dlp, ffmpeg, and the Whisper API
• Execution occurs through Python interpreters or skill CLI commands, not Node.js runtimes

Frequently Asked Questions

Does bradautomates/claude-video use Node.js or JavaScript?

No. The repository is implemented entirely in Python using standard library and third-party packages like yt-dlp. There are no JavaScript files, package.json configurations, or index.js entry points in the codebase. The skill definition in skills/watch/SKILL.md references only Python scripts.

What file should I examine instead of index.js to understand the skill?

Examine skills/watch/scripts/watch.py as the primary entry point, and review skills/watch/SKILL.md for the command specification and skill metadata. These files define how the /watch command processes video URLs and coordinates the extraction pipeline between download.py, frames.py, and transcribe.py.

Why might someone expect an index.js file in this repository?

Developers familiar with Node.js projects often expect index.js as the default entry point for CLI tools or web servers. However, claude-video follows Python packaging conventions where __main__.py or specific script files like watch.py serve as entry points. The confusion may also stem from using npx to install the skill globally, even though the skill itself executes Python code.

How do I run the video processing scripts manually?

Navigate to the repository root and execute the Python module directly:

python -m skills.watch.scripts.watch <video_url>

Ensure you have Python 3.x, yt-dlp, and ffmpeg installed in your environment, as these are required by the scripts in skills/watch/scripts/. The repository also includes a tests/ directory with pytest-based validation suites for offline testing.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}