К основному содержанию
скилл CX Codex

cloud-uploader — скилл для Claude Code: загрузка в облако

Скилл cloud-uploader загружает проморолики и сэмплер альбома в Cloudflare R2 или AWS S3. Используйте его после подготовки видео, когда файлы нужно разместить в облаке.

CC0-1.0 247 установок ★ 686 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill cloud-uploader -a claude-code
Открыть на GitHub

Что делает cloud-uploader

Скилл отправляет проморолики и альбомный сэмплер в Cloudflare R2 или AWS S3. Перед загрузкой он предлагает проверить настройки и наличие файлов, а затем запустить предварительный просмотр с --dry-run. Можно отправить все файлы, только проморолики или только сэмплер; флаг --public включает публичный доступ.

Для работы нужны учётные данные облачного хранилища в ~/.bitwize-music/config.yaml, включённая настройка cloud.enabled: true и библиотека Python boto3. Также заранее создайте проморолики через /bitwize-music:promo-director. Без видео для альбома загружать будет нечего.

Файлы размещаются в бакете по пути {artist}/{album}/, без папки жанра. Загрузка выполняется вручную, а не автоматически; скрипт использует Python из ~/.bitwize-music/venv, если это окружение доступно.

Какие задачи решает

  • загрузить проморолики альбома в R2 или S3
  • перед отправкой посмотреть список файлов и размеры
  • отправить в облако только сэмплер альбома
  • открыть загруженные файлы для публичного доступа

Примеры запросов агенту

  • Загрузи проморолики и сэмплер альбома my-album в облако: /bitwize-music:cloud-uploader my-album
  • Покажи, какие файлы альбома my-album будут отправлены, но пока ничего не загружай: /bitwize-music:cloud-uploader my-album --dry-run
  • Загрузи только проморолики альбома my-album: /bitwize-music:cloud-uploader my-album --type promos

Как установить cloud-uploader

1Через Skills CLI (Vercel)

npx skills add bitwize-music-studio/claude-ai-music-skills --skill cloud-uploader -a claude-code

2Вручную: положить файлы

~/.claude/skills/cloud-uploader/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cloud-uploader/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cloud-uploader

Как установить cloud-uploader в Claude Code?

Выполните npx skills add bitwize-music-studio/claude-ai-music-skills --skill cloud-uploader -a claude-code. Файл скилла появится по пути ~/.claude/skills/cloud-uploader/SKILL.md.

Что делает cloud-uploader?

Загружает проморолики и сэмплер альбома в Cloudflare R2 или AWS S3. Перед отправкой можно проверить список файлов через режим --dry-run.

Что нужно настроить для загрузки в R2 или S3?

В ~/.bitwize-music/config.yaml нужны включённая настройка cloud.enabled: true, параметры провайдера и бакет. Для Python требуется boto3, а проморолики нужно подготовить заранее.

Исходный текст

SKILL.md · CC0-1.0
---
name: cloud-uploader
description: Uploads promo videos and content to Cloudflare R2 or AWS S3. Use when the user wants to host promo content for social media or distribution.
model: sonnet
effort: low
prerequisites:
  - promo-director
allowed-tools:
  - Read
  - Bash
  - Glob
requirements:
  python:
    - boto3
---

# Cloud Uploader Skill

Upload promo videos and other album content to cloud storage (Cloudflare R2 or AWS S3).

## Purpose

After generating promo videos with `/bitwize-music:promo-director`, upload them to cloud storage for:
- Hosting on websites
- Sharing via direct links
- CDN distribution
- Backup and archival

## When to Use

- After promo videos generated, user wants to upload to cloud
- User says "upload promos to R2" or "upload to S3"
- User says "upload promo videos for [album]"
- Manual invocation only (not automatic)

## Position in Workflow

```
Generate → Master → Promo Videos → **[Cloud Upload]** → Release
```

Optional step after promo-director, before release-director.

## Prerequisites

### Cloud Configuration

Cloud credentials must be configured in `~/.bitwize-music/config.yaml`:

```yaml
cloud:
  enabled: true
  provider: "r2"  # or "s3"

  # For Cloudflare R2
  r2:
    account_id: "your-account-id"
    access_key_id: "your-access-key"
    secret_access_key: "your-secret-key"
    bucket: "promo-videos"

  # For AWS S3
  s3:
    region: "us-west-2"
    access_key_id: "your-access-key"
    secret_access_key: "your-secret-key"
    bucket: "promo-videos"
```

See `${CLAUDE_PLUGIN_ROOT}/reference/cloud/setup-guide.md` for detailed setup instructions.

### Required Files

- Promo videos generated (run `/bitwize-music:promo-director` first)
- Located at: `{audio_root}/artists/{artist}/albums/{genre}/{album}/promo_videos/`
- Album sampler at: `{audio_root}/artists/{artist}/albums/{genre}/{album}/album_sampler.mp4`

### Python Dependencies

```bash
# If using the shared venv (recommended)
~/.bitwize-music/venv/bin/pip install -r ${CLAUDE_PLUGIN_ROOT}/requirements.txt

# Or install separately
pip install boto3
```

The upload script uses `~/.bitwize-music/venv` if available, otherwise falls back to system Python.

## Workflow

### 1. Verify Prerequisites

**Check config:**
```bash
cat ~/.bitwize-music/config.yaml | grep -A 20 "cloud:"
```

Verify:
- `cloud.enabled: true`
- Provider credentials configured (r2 or s3)
- Bucket name set

**Check promo videos exist:**
```bash
ls {audio_root}/artists/{artist}/albums/{genre}/{album}/promo_videos/
ls {audio_root}/artists/{artist}/albums/{genre}/{album}/album_sampler.mp4
```

If missing:
```
Error: Promo videos not found.

Generate with: /bitwize-music:promo-director {album}
```

### 2. Get Python Command

**Call `get_python_command()` first** to get the venv Python path and plugin root. Use these for all bash invocations below.

```
PYTHON="{python from get_python_command}"
PLUGIN_DIR="{plugin_root from get_python_command}"
```

### 3. Preview Upload (Dry Run)

Preview first:
```bash
$PYTHON "$PLUGIN_DIR/tools/cloud/upload_to_cloud.py" {album} --dry-run
```

Output shows:
- Provider and bucket
- Files to upload
- S3 keys (paths in bucket)
- File sizes

### 4. Upload Files

**Upload all (promos + sampler):**
```bash
$PYTHON "$PLUGIN_DIR/tools/cloud/upload_to_cloud.py" {album}
```

**Upload only track promos:**
```bash
$PYTHON "$PLUGIN_DIR/tools/cloud/upload_to_cloud.py" {album} --type promos
```

**Upload only album sampler:**
```bash
$PYTHON "$PLUGIN_DIR/tools/cloud/upload_to_cloud.py" {album} --type sampler
```

**Upload with public access:**
```bash
$PYTHON "$PLUGIN_DIR/tools/cloud/upload_to_cloud.py" {album} --public
```

### 5. Verify Upload

**For R2:**
- Check Cloudflare dashboard → R2 → Your bucket
- Files should appear under `{artist}/{album}/`

**For S3:**
- Check AWS Console → S3 → Your bucket
- Or use AWS CLI: `aws s3 ls s3://{bucket}/{artist}/{album}/`

### 5. Report Results

```
## Cloud Upload Complete

**Provider:** R2 (or S3)
**Bucket:** {bucket}
**Album:** {album}

**Uploaded Files:**
- {artist}/{album}/promos/01-track_promo.mp4
- {artist}/{album}/promos/02-track_promo.mp4
- ...
- {artist}/{album}/promos/album_sampler.mp4

**Total:** 11 files, 125.4 MB

**Next Steps:**
1. Verify files in cloud dashboard
2. If public: Test URLs work
3. Continue to release: /bitwize-music:release-director {album}
```

## Upload Path Structure

**IMPORTANT: Cloud paths are FLAT - no genre folder.**

The cloud path structure is different from the local content structure:

| Location | Path Structure |
|----------|----------------|
| Local content | `{content_root}/artists/{artist}/albums/{genre}/{album}/` |
| Local audio | `{audio_root}/artists/{artist}/albums/{genre}/{album}/` |
| **Cloud** | `{artist}/{album}/` (no genre!) |

Files are organized in the bucket as:

```
{bucket}/
└── {artist}/
    └── {album}/
        └── promos/
            ├── 01-track_promo.mp4
            ├── 02-track_promo.mp4
            ├── ...
            └── album_sampler.mp4
```

**Example for album "my-album" by "bitwize" in rock genre:**
- Local: `~/music/artists/bitwize/albums/rock/my-album/`
- Cloud: `bitwize/my-album/promos/` (NOT `bitwize/albums/rock/my-album/`)

## Command Options

| Option | Description |
|--------|-------------|
| `--type promos` | Upload only track promo videos |
| `--type sampler` | Upload only album sampler |
| `--type all` | Upload both (default) |
| `--dry-run` | Preview without uploading |
| `--public` | Set files as public-read |
| `--audio-root PATH` | Override audio_root from config |

## Invocation Examples

**Basic upload:**
```
/bitwize-music:cloud-uploader my-album
```

**Preview only:**
```
/bitwize-music:cloud-uploader my-album --dry-run
```

**Upload promos only:**
```
/bitwize-music:cloud-uploader my-album --type promos
```

**Upload with public access:**
```
/bitwize-music:cloud-uploader my-album --public
```

## Error Handling

**"Cloud uploads not enabled"**
- Add `cloud.enabled: true` to config
- See `${CLAUDE_PLUGIN_ROOT}/reference/cloud/setup-guide.md`

**"Credentials not configured"**
- Add credentials to config file
- For R2: account_id, access_key_id, secret_access_key
- For S3: access_key_id, secret_access_key

**"Album not found"**
- Check album exists in `{audio_root}/artists/{artist}/albums/{genre}/{album}/`
- Verify artist name in config matches

**"No files found to upload"**
- Generate promo videos first: `/bitwize-music:promo-director {album}`

**"Access Denied"**
- Check credentials are correct
- For R2: Verify API token has write permissions
- For S3: Verify IAM policy allows s3:PutObject

**"Bucket not found"**
- Create bucket first in cloud dashboard
- Verify bucket name in config

## Security Notes

- Credentials stored in config file (ensure proper file permissions)
- Config file should be gitignored in user's content repo
- Default: Files uploaded as private (not public)
- Use `--public` flag only for files intended for public access
- Consider using environment variables for CI/CD (future enhancement)

## Integration with Other Skills

### Handoff FROM

**promo-director:**

After promo generation:
```
Promo videos generated successfully.

**Optional:** Upload to cloud storage: /bitwize-music:cloud-uploader {album}
```

### Handoff TO

**release-director:**

After cloud upload:
```
Cloud upload complete.

Ready for release workflow: /bitwize-music:release-director {album}
```

## Supported Providers

### Cloudflare R2

- S3-compatible API
- No egress fees
- Global CDN integration
- Good for high-traffic content

### AWS S3

- Industry standard
- Fine-grained IAM permissions
- CloudFront CDN available
- Good for AWS ecosystem integration

## Future Enhancements

- Environment variable credentials (for CI/CD)
- Multiple bucket support
- Automatic CDN invalidation
- Progress bar for large uploads
- Resume failed uploads
- Bucket creation if missing
- Additional providers (Backblaze B2, DigitalOcean Spaces)

## Related Documentation

- `${CLAUDE_PLUGIN_ROOT}/reference/cloud/setup-guide.md` - Detailed setup instructions
- `${CLAUDE_PLUGIN_ROOT}/skills/promo-director/SKILL.md` - Generate promo videos
- `${CLAUDE_PLUGIN_ROOT}/skills/release-director/SKILL.md` - Release workflow

## Model Recommendation

**Sonnet 4.5** - This skill runs scripts and coordinates workflow. No creative output from LLM.

## Version History

- v0.14.0 - Initial implementation
  - R2 and S3 support via boto3
  - Dry-run mode
  - Public/private upload options
  - Path organization by artist/album

© bitwize-music-studio · CC0-1.0 · bitwize-music-studio/claude-ai-music-skills

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
analyzing-cloud-storage-access-patterns mahipal Скилл analyzing-cloud-storage-access-patterns читает логи обращений к S3, GCS и Azure Blob и показывает, где поведение выбивается из обычного: ночные выгрузки, новые IP, всплески GetObject. CX Codex +1 578установок syncfusion-react-file-manager Syncfusion Inc Скилл syncfusion-react-file-manager помогает настроить компонент файлового менеджера Syncfusion в React: от локального JSON до подключения к Azure Blob Storage или S3. Пригодится при сборке проводника с загрузкой файлов. CX Codex +1 760установок r2-upload zebbern Скилл r2-upload для Claude Code и Codex. Загружает файлы в Cloudflare R2, AWS S3 и совместимые хранилища, затем выдаёт временную ссылку на скачивание без постоянной публичной ссылки. CX Codex +1 ★ 4 719звёзд репо waf-setup devops-skills Скилл waf-setup разворачивает и настраивает веб-прикладной файрвол: правила AWS WAF, Cloudflare и ModSecurity под защиту от атак из OWASP Top 10. CX Codex +1 416установок cdn-setup devops-skills Скилл cdn-setup помогает настроить CDN через CloudFront и Cloudflare: раздавать статику, защищать трафик по TLS и сбрасывать кеш. Пригодится при публикации сайтов и API. CX Codex +1 361установок cloudflare-workers-migration secondsky Скилл cloudflare-workers-migration для переноса приложений на Cloudflare Workers с AWS Lambda, Vercel, Express и Node.js. Автоматически адаптирует обработчики, middleware и переменные окружения под Web API. CX Codex +1 316установок

Из того же набора52

Весь набор →
validate-album Скилл validate-album проверяет каталоги музыкального альбома, пути к аудиофайлам и поля треков перед релизом. Скилл опирается на утилиты MCP-сервера bitwize-music-mcp. CX Codex +1 248установок researchers-financial Скилл researchers-financial для Claude Code исследует финансовые документы и рыночные данные для музыкальных проектов о компаниях, финансовых преступлениях и событиях рынка. Он собирает источники и отмечает факты для проверки человеком. CX Codex +1 248установок next-step Скилл next-step определяет текущий статус музыкального альбома и подсказывает один следующий шаг с нужной командой. CX Codex +1 247установок configure Скилл configure для Claude Code интерактивно создаёт и редактирует ~/.bitwize-music/config.yaml для музыкальных плагинов bitwize-music. CX Codex +1 247установок resume Скилл resume для Claude Code находит альбом по названию и показывает его статус и следующий конкретный шаг. Показывает, на каком этапе находится незавершённый альбом. CX Codex +1 246установок researchers-primary-source Скилл researchers-primary-source для Claude Code собирает высказывания субъекта из твитов, блогов, форумов и чатов. Ищет прямые цитаты и первичные источники вместо пересказов. CX Codex +1 246установок promote-idea Скилл promote-idea для Claude Code переводит идею альбома из IDEAS.md в рабочий проект одной командой. Меняет статус идеи на In Progress. CX Codex +1 188установок health-check Скилл health-check диагностирует состояние плагина: проверяет пакеты в виртуальном окружении, регистрацию скиллов и коллизии slug-ов альбомов. Запускается когда нужно убедиться, что всё настроено правильно или найти причину ошибок. CX Codex +1 187установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой