yojuhsu/video-cut

¿Qué hace video-cut?

Skill de Claude Code que encuentra automáticamente material en la fototeca de macOS, reconstruye la ruta usando GPS y tiempo, edita videoclips cortos y añade subtítulos y música.

Descripción

Este skill automatiza el proceso de creación de videos cortos editados a partir de tu fototeca de macOS Photos. Utiliza los metadatos de ubicación (GPS) y las marcas de tiempo de las fotos y videos para reconstruir la secuencia de un viaje o evento, seleccionar los clips más representativos y ensamblarlos en un video corto con subtítulos y música de fondo.

Instalación

1. Asegúrate de tener Claude Code instalado y configurado.
2. Clona o descarga este repositorio en tu máquina local.
3. Coloca la carpeta del skill en el directorio de skills de Claude Code (normalmente ~/.claude/skills/).
4. Los scripts dependen de herramientas de línea de comandos de macOS como osascript, ffmpeg, y exiftool. Asegúrate de tenerlas instaladas.

Uso

Ejemplos de prompts que puedes usar con Claude Code:

• "Crea un video corto de mis vacaciones en París del año pasado usando las fotos de mi fototeca."
• "Encuentra el material de la excursión de la semana pasada y haz un resumen en video."
• "Genera un video de 30 segundos con los eventos de mi cumpleaños, añade subtítulos y música tranquila."

Cómo funciona

1. Búsqueda de material: Utiliza osascript para consultar la base de datos de macOS Photos y filtrar por fecha, ubicación o álbum.
2. Extracción de metadatos: Emplea exiftool para leer las coordenadas GPS y las marcas de tiempo de cada foto/video.
3. Reconstrucción de ruta: Ordena el material cronológicamente y utiliza la información GPS para identificar puntos clave del recorrido.
4. Selección de clips: Elige los clips más representativos para ajustarse a la duración deseada.
5. Edición y montaje: Usa ffmpeg para concatenar los videos, añadir transiciones, superponer subtítulos y agregar una pista de música.
6. Salida: El video final se guarda en una ubicación especificada (por ejemplo, el escritorio).

Requisitos del sistema

• macOS 10.15 o superior
• Claude Code instalado
• ffmpeg (instalable vía Homebrew: brew install ffmpeg)
• exiftool (instalable vía Homebrew: brew install exiftool)

Estructura del proyecto

yojuhsu/video-cut/
├── SKILL.md
├── scripts/
│   ├── buscar_material.sh
│   ├── extraer_metadatos.sh
│   ├── reconstruir_ruta.sh
│   └── editar_video.sh
└── README.md

Notas

• El skill solo funciona en macOS debido a su dependencia de osascript y la aplicación Photos.
• La calidad del video resultante depende de la calidad y cantidad del material disponible en la fototeca.
• Asegúrate de que tu fototeca tenga permisos de acceso para Claude Code.

Licencia

MIT