remotion-video-studio: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Claude Code Plugin that provides a complete video creation toolkit integrating Remotion framework with multi-provider Text-to-Speech services. When working on this codebase, you are developing the plugin itself, not using it to create videos.

Plugin Architecture

Component Structure

remotion-video-studio/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest (name, version, metadata)
├── commands/                # User-facing slash commands (*.md files)
│   ├── video-setup.md       # TTS provider configuration workflow
│   ├── video-new.md         # Create new Remotion video project
│   ├── video-add-voice.md   # Add voiceover to existing project
│   ├── video-render.md      # Render final video output
│   ├── video-record-setup.md # Configure screen recording
│   └── video-help.md        # Documentation command
├── skills/                  # Specialized knowledge bases
│   ├── remotion/SKILL.md    # Remotion framework expertise
│   └── tts-integration/SKILL.md # TTS provider integration patterns
├── agents/
│   └── video-creator.md     # Video creation specialist agent
├── README.md                # User documentation
└── CLAUDE.md                # This file

Command Files (*.md)

Commands are markdown files with YAML frontmatter in the commands/ directory:

---
description: Brief description shown in help
argument-hint: [optional-arg] or none
---

Each command file contains:

• Arguments section: How to parse user input (flags, positional args)
• Workflow steps: Detailed implementation logic
• Interactive questions: Use when information is missing
• Error handling: Common failure modes and resolutions
• Success output: What to display when complete

Key Pattern: Commands orchestrate workflows by:

1. Reading plugin configuration (.claude/video-config.json)
2. Asking clarifying questions when needed
3. Executing Remotion/TTS operations
4. Providing clear user feedback
5. Setting up project structure for user's video projects