Communitygithub.com

Doc Real

Estilo de edición de video con realismo documental: fotograma letterboxed, grado cinematográfico, subtítulos en minúsculas pequeñas y una etiqueta de ubicación. Ideal para minidocumentales, historias de fundadores, viajes, entrevistas y películas de marca. Convierte un clip en bruto en una edición final 9:16 usando el motor video-studio-core (transcripción, corte automático, gráficos en movimiento, sonido, gradación).

¿Qué es Doc Real?

Doc Real es un skill de edición de video estilo documental impulsado por IA, diseñado como un complemento ("skin") para el motor principal video-studio-core. Transforma clips de cámara en bruto en videos verticales de formato 9:16 con un acabado cinematográfico realista, que incluye fotograma letterboxed, gradación de color profesional, granulado, sutiles movimientos de cámara (push-in), subtítulos pequeños en minúsculas centrados en la parte baja y una etiqueta de ubicación o capítulo en la esquina superior izquierda. Es especialmente útil para creadores de contenido, documentalistas, fundadores o equipos de marketing que quieran producir minidocumentales, entrevistas, historias de viajes o películas de marca con un acabado profesional y coherente. El flujo de trabajo es completamente automatizado: el skill transcribe el audio, identifica palabras clave, genera un plan de edición (incluyendo cortes, gráficos y música), y renderiza el video final. Soporta múltiples formatos (9:16, 1:1, 4:5, 16:9) mediante el parámetro "--format" y permite refinar manualmente el plan de edición editando el archivo plan.json, ajustando el hook inicial, corrigiendo palabras mal transcritas o añadiendo capítulos con la clase "dr-chapter". También incluye comprobaciones de calidad como la generación de una hoja de contacto (contact_sheet.png) para verificar la legibilidad de los textos y el encuadre antes del renderizado completo. Está diseñado para ejecutarse en sistemas que tengan Python y FFmpeg, y requiere la instalación previa del skill video-studio-core en la misma carpeta de skills.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Viprasol-Tech/claude-video-editing-skills/tree/HEAD/plugins/video-studio/skills/doc-real

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Doc Real?

Realismo documental: fotograma letterboxed, grado cinematográfico, subtítulos pequeños en minúsculas y una etiqueta de ubicación.

  • Ideal para: minidocumentales, historias de fundadores, viajes, entrevistas, películas de marca
  • Categoría: Reel de entrevista
  • Formato predeterminado: 9:16 (cambiar con --format 9:16 | 1:1 | 4:5 | 16:9)
  • Requiere metraje de cámara: sí, un clip de entrevista en bruto
  • Texto detrás del orador: no

Antes de empezar

Este estilo se ejecuta sobre el skill video-studio-core, que debe estar instalado en la misma carpeta de skills.

  • CORE = la carpeta video-studio-core junto a esta (p. ej. ~/.claude/skills/video-studio-core).
  • STYLE = la carpeta de este skill (contiene theme.json y theme.css).
  • Primera vez en una máquina: python CORE/scripts/check_env.py, y corrige cualquier cosa que informe.
  • Si CORE falta, dile al usuario que instale video-studio-core desde el mismo paquete.

Realizar la edición

python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-doc-real --stop-after plan --title "lugar, hora"
# refinar edit-*/plan.json (ver más abajo), luego comprobar fotogramas:
python CORE/scripts/render.py edit-doc-real/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-doc-real/plan.json
python CORE/scripts/finish.py edit-doc-real/plan.json

Abre contact_sheet.png y míralo antes del renderizado completo. El video final es final.mp4 en la carpeta de trabajo. Usa --formats 1:1,16:9 en finish.py para tamaños adicionales. Agrega música con "music": {"src": "track.mp3", "volume": 0.12} en el plan.

El aspecto

  • Barras letterbox, grado cinematográfico, granulado, push lento. Subtítulos pequeños, en minúsculas, blancos, centrados en la parte baja.
  • Una pequeña etiqueta de ubicación o capítulo arriba a la izquierda en los primeros 3 segundos. Sin zooms, sin emojis, sin efectos de sonido.

Refinar el plan

El borrador de make_plan.py es automático. Hazlo bueno:

  • Lee words.json y reescribe el gancho (primeros 2-3 s) en una promesa corta y específica.
  • Reemplaza palabras clave débiles seleccionadas automáticamente con las palabras que transmiten el significado (números, resultados, nombres, contrastes).
  • Corrige cualquier palabra mal interpretada en el array words (mantén sus tiempos).
  • Pasa una ubicación/contexto como --title (p. ej. 'julana, haryana — 6:40 am').
  • Agrega saltos de capítulo titlecard con la clase dr-chapter para películas más largas.
  • Tipos de elementos y campos: CORE/references/plan-schema.md.

Comprobar antes de entregar

  • Hoja de contacto: texto legible, nada cortado, nada cubriendo el rostro a menos que sea intencional, zonas seguras respetadas (9:16: mantener el texto entre el 10% y el 85% de la altura).
  • Cuida la sincronización: las superposiciones aparecen con la palabra hablada, no después.
  • ffprobe el archivo final: tamaño correcto, duración y audio.
  • Dile al usuario qué recortaste (segundos eliminados), qué añade el look y dónde está el archivo.

Cambiar el aspecto

Los colores y las fuentes están en theme.json (vars, fontsUrl) y theme.css. Para un cambio puntual, edita plan.json (theme.vars, estilo del elemento) en lugar de los archivos del skill.

Ejemplos de solicitudes

  • "Edición de estilo documental."
  • "Haz que mi historia parezca un docu de Netflix."
  • "Look documental cinematográfico con una etiqueta de ubicación."

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills relacionados