agentleFS
MaikozortMaikozort/social-publish-kit/skills/analizar-video/SKILL.md

analizar-video

Skill1 starsChanged 29 days agoMITView on GitHub

Analiza un archivo de video (short, reel, tiktok o video largo) para saber qué se ve, qué se dice, de qué trata, cuál es el mejor momento para el hook y la portada, qué capítulos tiene y qué problemas o faltantes hay antes de publicarlo. Extrae fotogramas y transcripción en local con ffmpeg y Whisper. Úsala cuando alguien comparta la ruta de un video y pida revisarlo, resumirlo o prepararlo para publicar, o como paso de análisis dentro de la skill publicar.

  • Installs packages

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No puedes ver un video directamente.

    line 8
  2. Distinctive:

    No identifiques a personas reales por su cara.

    line 91

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Analizar un video

No puedes ver un video directamente. Este script lo convierte en lo que sí puedes revisar: fotogramas (imágenes con su segundo exacto) y transcripción con tiempos. Todo se procesa en el computador del usuario.

1. Ejecutar el script

Desde la carpeta de esta skill:

python scripts/analizar_video.py "RUTA/AL/VIDEO.mp4" --salida "analisis-<nombre>"

Opciones útiles:

  • --idioma es si sabes el idioma (más rápido y preciso que la detección automática).
  • --modelo base en equipos lentos; --modelo medium si el audio es difícil.
  • --max-fotogramas 40 para videos largos.
  • --sin-transcripcion si solo necesitas lo visual.

Si falla:

  • ffmpeg no encontrado → pide instalarlo (https://ffmpeg.org/download.html) o trabaja con el resumen del usuario.
  • Sin motor de transcripción → el script lo dice en info.json. Sigue con los fotogramas y pide al usuario un resumen de lo que se dice, o sugiere pip install faster-whisper.
  • Transcribir tarda (la primera vez descarga el modelo) → ejecútalo en segundo plano si tu entorno lo permite.

2. Revisar la salida

  • info.json: duración, resolución, orientación, audio, lista de fotogramas y estado de la transcripción.
  • fotogramas/*.jpg: míralos todos, en orden. El nombre lleva el tiempo (f03_00-12.jpg = segundo 12).
  • transcripcion.txt: lo que se dice, con tiempos. transcripcion.srt: listo para subir como subtítulos.

Si un tramo importante queda sin fotograma (un cambio brusco entre dos), extrae uno extra:

ffmpeg -v error -ss 00:00:15 -i "VIDEO.mp4" -frames:v 1 extra_00-15.jpg

3. Reporte

Entrega este reporte, corto y concreto:

## Análisis del video

**Ficha técnica:** 0:42 · vertical 1080x1920 · 60 fps · con audio · idioma: español

**De qué trata:** <2-3 líneas>

**Qué se ve, por tramos**
- 00:00-00:05: …
- 00:05-00:18: …

**Qué se dice:** <resumen; citas textuales cortas de las frases clave>

**Tema / juego detectado:** <nombre> (seguro / probable / no identificado; por qué)

**Mejor momento para el hook:** <segundo y por qué>. ¿El video arranca con él? Si no, sugiere recortar.

**Fotograma recomendado para portada:** <archivo y segundo>

**Capítulos sugeridos** (solo videos largos, mínimo 3, cada uno ≥10 s):
00:00 …

**Palabras clave detectadas:** <dichas o vistas en pantalla>

**Alertas**
- Música comercial o audio de terceros → riesgo de Content ID o silenciado
- Marcas o productos visibles → ¿patrocinio?
- Contenido sensible (violencia gráfica, lenguaje fuerte) → restricción de edad
- Personas o escenas que parezcan alteradas con IA → etiqueta de IA
- Texto o elementos importantes en zonas que tapa la interfaz (vertical: arriba, abajo, lado derecho)
- Subtítulos ya quemados en el video → no activar subtítulos automáticos que se superpongan (Facebook)
- Rótulos o textos en pantalla que prometen algo que el video no cumple
- Cortes, pantallas negras o pérdida de captura
- Calidad: audio bajo o saturado, imagen borrosa, inicio lento

**Lo que no queda claro para el espectador:** <contexto que falta; qué explicar en el copy>

**Recomendaciones:** <2-4 acciones concretas>

Reglas

  • Describe lo que ves y oyes, no lo que supones. Si algo es incierto, dilo ("parece ser…").
  • Si el usuario dio un resumen, compáralo con lo que encontraste. Si se contradicen, pregunta.
  • Whisper escribe mal nombres propios (clases, personajes, jerga). Corrígelos con lo que se ve en pantalla y no los copies mal al copy.
  • Identificar el juego: fíjate en la interfaz (HUD), menús, logos y nombres en pantalla. Si no estás seguro, pregunta.
  • No identifiques a personas reales por su cara. Usa solo nombres que aparezcan en pantalla, en el audio o que dé el usuario.
  • La carpeta de análisis queda en el equipo del usuario. Al terminar, dile dónde está y que puede borrarla.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.