# Creator Hub

Claude Code plugin with skills focused on content creation.

## Overview

Creator Hub provides specialized skills that extend Claude Code's capabilities for content creation workflows. Each skill is designed with a **git-like staging workflow** - operations generate previews that must be approved before finalizing, giving you full control over the output.

The plugin philosophy is to let Claude handle the complexity of tools like FFmpeg while you focus on describing what you want. All operations are non-destructive by default.

## Requirements

- **FFmpeg** - For video/audio processing ([installation guide](https://ffmpeg.org/download.html))
- **Python 3.8+** - For running skill scripts
- **mpv** or **VLC** - For previewing results (optional, configurable)

## Installation

### Local directory (development)
```bash
claude --plugin-dir ./creator-hub
```

### Via GitHub
```bash
/plugin marketplace add github.com/arthurbm/creator-hub
/plugin install video-editor@creator-hub
```

## Available Skills

| Skill | Description |
|-------|-------------|
| [video-editor](skills/video-editor/) | FFmpeg-based video editing with staging workflow |

## How It Works

All skills in Creator Hub follow a **git-like staging workflow**:

```
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Request   │────▶│   Staging   │────▶│   Approve   │
│  "cut video │     │  (preview)  │     │  or Discard │
│   1:30-2:45"│     │             │     │             │
└─────────────┘     └─────────────┘     └─────────────┘
```

1. **You describe** what you want in natural language
2. **Claude executes** the operation and saves the result to staging
3. **You preview** the result in your media player
4. **You decide** to approve (save to final destination) or discard

This workflow ensures you never accidentally overwrite files and always have a chance to review before committing.

## Usage Examples

```
You: "Cut the intro from video.mp4, from the start until 0:30"
Claude: [executes FFmpeg, saves to staging, opens preview]
        "Preview ready. Approve or discard?"

You: "Looks good, save as intro.mp4"
Claude: [moves from staging to intro.mp4]
        "Saved: intro.mp4"
```

```
You: "Optimize all .mp4 files in this folder for WhatsApp"
Claude: [batch processes all files to staging]
        "5 previews ready. Review and approve?"
```

## Contributing

Want to add a new skill? Skills are self-contained directories with:

```
skill-name/
├── SKILL.md        # Instructions for Claude (required)
├── scripts/        # Python scripts for operations
└── references/     # Documentation and guides
```

See [Creating Skills](https://docs.anthropic.com/en/docs/claude-code/skills) for detailed guidance.

## Structure

```
creator-hub/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── video-editor/
│       ├── SKILL.md
│       ├── README.md
│       ├── scripts/
│       └── references/
├── README.md
└── LICENSE
```

## License

MIT