Communitygithub.com

Hasnan42/Showfolio

Convierte el proyecto actual de Octacer en un vídeo promocional pulido con la marca Octacer (de unos 40, 60 o 90 segundos) usando Hyperframes. Las pantallas reales del proyecto permanecen intactas; todo lo que las rodea (introducción, títulos, fondos, final, logotipo animado) utiliza la marca Octacer.

¿Qué es Showfolio?

Showfolio es una skill para agentes de IA (como Claude Code) que automatiza la creación de vídeos promocionales cortos para proyectos de software, aplicando la marca visual de Octacer. La skill guía al agente a través de un flujo de trabajo estructurado: primero realiza una breve encuesta al usuario para conocer la duración deseada (40, 60 o 90 segundos), las funciones o páginas a destacar y el propósito del proyecto en una línea. Luego inspecciona el código del proyecto para comprender la aplicación, planifica un storyboard detallado y un guion, y finalmente entrega un brief de composición a Hyperframes, quien se encarga de la implementación técnica del vídeo. El resultado es un vídeo en formato MP4 con la marca Octacer (colores, tipografía y logotipo animado) que resalta las pantallas reales del producto. Además, la skill permite personalizar el tono (desde 'pulido' hasta 'caótico' o 'cinematográfico'), incluir narración opcional y configurar aspectos como la duración, el formato y la música. Es ideal para desarrolladores que quieren mostrar sus creaciones de forma profesional sin esfuerzo.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Hasnan42/Showfolio/tree/HEAD/skills/showfolio

Preguntar en tu IA favorita

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

Documentación

/showfolio

Lo construiste. Ahora muéstralo.

Despacho de invocación (debe ocurrir primero)

Verificación de modelo. Si eres Claude Opus 5.5 y la invocación no solicita el flujo de trabajo completo (--full, "usa el showfolio completo") ni la narración (--voice, que showfolio-slim no maneja), cambia a showfolio-slim: lee <skill-dir>/slim.md (la skill /showfolio-slim, incluida aquí) y síguela para el resto de esta ejecución en lugar de este archivo. Transmite la entrada del usuario y pasa cualquier otra opción (--no-music, --title, …) como instrucciones en lenguaje natural. Informa al usuario en una línea primero, por ejemplo: "Estás en Opus 5.5, así que usaré /showfolio-slim: construyo todo el vídeo yo mismo. Di 'usa el showfolio completo' para volver al modo completo." Si eres cualquier otro modelo, o no puedes determinar cuál eres, omite esta verificación.

Antes de inspeccionar el proyecto, analiza la invocación completa de /showfolio. Si la invocación contiene --voice, establece voice.enabled = true. Habilita la narración solo para esa ejecución. No habilites la narración automáticamente ni recurras al flujo de trabajo sin voz.

/showfolio convierte el sitio web o la aplicación del proyecto actual en un vídeo promocional pulido y compartible usando Hyperframes, presentado como un proyecto creado por Octacer. Es específico, con opiniones y divertido.

La marca Octacer siempre está presente. Las pantallas reales del proyecto aparecen tal como son, y el marco que las rodea (introducción con logotipo animado, títulos, fondos, etiquetas, logotipo en esquina, final) es de Octacer. Reglas y recursos: references/brand.md y <skill-dir>/assets/brand/.

Qué hace esta skill

  1. Pregunta al usuario tres preguntas de admisión (duración, qué destacar, propósito) y obtiene credenciales de prueba si la aplicación requiere inicio de sesión.
  2. Lee el código del proyecto actual para comprender la aplicación.
  3. Planifica un concepto de presentación específico para este proyecto.
  4. Escribe el guion y el storyboard del vídeo dentro del marco de la marca Octacer.
  5. Entrega un brief de composición enfocado a Hyperframes.
  6. Valida, renderiza y escribe el texto para compartir.

Análisis de la invocación

El usuario puede invocar con lenguaje natural o banderas:

/showfolio
/showfolio --duration 60
/showfolio --tone polished --format vertical
/showfolio esto. Haz que parezca una película de producto premium.

Analiza estas opciones:

OpciónValoresPredeterminado
--tonepredefinido o descripción libreinferido
--formatlandscape, vertical, squarelandscape
--durationsegundos (aproximadamente 40, 60 o 90)se pregunta en el Paso 0
--no-musicbanderamúsica activada
--no-sfxbanderaefectos de sonido activados
--titlecadenainferido del proyecto
--voicebanderanarración desactivada

La voz es opcional. Si --voice está presente, usa Kokoro a través de Hyperframes y no agregues ninguna lógica de selección de proveedor. El flujo de trabajo de voz es intencionalmente de un solo proveedor.

El tono puede ser un predefinido (default, polished, yc-parody, chaotic, deadpan, cinematic, app-store) o una dirección creativa como "falso lanzamiento Serie A de 2016", "exhibición de museo" o "anuncio de juego móvil sobreproducido".

Cuando el usuario da una dirección de tono libre, asígnala al predefinido más cercano para el ritmo y la estructura, pero conserva la dirección del usuario en el plan y el brief de composición.

Guía de narración

Cuando --voice está habilitado, escribe una narración que complemente las imágenes, no simplemente lea el texto visible, coincida con el ritmo de la escena, suene natural y conversacional, y se mueva suavemente entre escenas. Mantén el guion conciso y específico del producto para que la voz se sienta como parte de la edición y no como una pista de narración separada.


Directorio de salida

Por defecto, la salida va a showfolio-output/. Para evitar sobrescribir ejecuciones anteriores, usa un directorio con marca de tiempo:

showfolio-output-2026-05-04-143022/

Usa una marca de tiempo cuando:

  • El usuario solicita explícitamente una nueva ejecución sin sobrescribir resultados anteriores
  • Ya existe un directorio showfolio-output/ en el proyecto

Genera la marca de tiempo al inicio de la ejecución (YYYY-MM-DD-HHmmss) y úsala de manera consistente para todas las rutas de salida de esa ejecución: plan, brief, composición, renderizado y texto para compartir.

Directorio de la skill

<skill-dir> es el directorio que contiene este SKILL.md. Claude Code lo imprime como "Directorio base para esta skill" cuando la skill se carga; para otros agentes, está donde se haya instalado la skill. Los recursos empaquetados están en <skill-dir>/assets/ y los scripts en <skill-dir>/scripts/. No adivines una ruta de instalación: una instalación mediante plugin, una copia en ~/.claude/skills/ y este repositorio la colocan en lugares diferentes.


Paso 0: Admisión

Lee: references/step-0-intake.md

Pregunta al usuario las tres preguntas de admisión (duración del vídeo, funciones/páginas a destacar, propósito en una línea) en un solo mensaje y espera las respuestas. Luego realiza la verificación de inicio de sesión: si las partes que se mostrarán requieren inicio de sesión, usa las credenciales proporcionadas por el usuario; de lo contrario, busca credenciales de prueba en el repositorio; si no las hay, pídele al usuario que las proporcione.

Puerta: Tienes una duración objetivo, una lista de elementos obligatorios a mostrar (con el favorito del usuario marcado) y un propósito en una línea. Si la aplicación necesita inicio de sesión, tienes credenciales de prueba funcionales o el usuario ha dicho que continúes sin ellas.


Paso 1: Inspeccionar el proyecto

Lee: references/step-1-inspect.md

Escanea el directorio del proyecto y extrae la información necesaria para planificar el vídeo. Presta especial atención a las funciones y páginas que el usuario seleccionó en el Paso 0.

Puerta: Puedes responder las 9 preguntas de la rúbrica de planificación.


Paso 2: Planificar y storyboard

Lee: references/step-2-plan.md Lee: references/brand.md

Escribe <output-dir>/showfolio-plan.md (donde <output-dir> es showfolio-output/ o la variante con marca de tiempo elegida anteriormente). Responde la rúbrica de planificación. Comprométete con un ángulo creativo. Escribe el storyboard paso a paso, incluyendo escenas, texto, tiempos, transiciones e indicaciones de efectos de sonido.

Cuando la música está seleccionada, incluye una sección compacta de Indicaciones de música: lee el preset de indicaciones de la pista incluida desde <skill-dir>/assets/music/cues/ si está presente; de lo contrario, indica que las indicaciones se detectarán en el momento de la composición (cualquier pista ahora admite sincronización de ritmo — consulta references/audio.md). Los metadatos de indicaciones son solo orientación opcional de temporización: la historia, la legibilidad, el ritmo y la claridad del producto siguen siendo lo principal.

Puerta: <output-dir>/showfolio-plan.md existe con un storyboard completo. Cada elemento obligatorio del Paso 0 tiene una escena. Las duraciones de las escenas suman la duración objetivo del Paso 0, con una tolerancia de ±10%.


Paso 3: Transferir a Hyperframes

Lee: Las skills de dominio de Hyperframes — hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-keyframes, hyperframes-cli. /showfolio tiene su propio flujo de trabajo: no entres en la entrevista de intención del punto de entrada de hyperframes ni te desvíes hacia su flujo de trabajo genérico de promoción / vídeo de lanzamiento. Lee: references/step-3-compose.md Lee: references/audio.md Lee: references/brand.md

Copia <skill-dir>/assets/brand/ en los recursos de la composición. Escribe el brief de composición y usa Hyperframes para crear la implementación del vídeo en <output-dir>/composition/.

/showfolio posee el ángulo del producto, el material fuente, el storyboard, el tono, el formato, la selección de audio, las indicaciones de música y las expectativas de entrega. Hyperframes posee la estructura concreta de la composición, la temporización exacta de las animaciones, la mecánica de las animaciones, las opciones de tiempo de ejecución, las reglas de linting y el flujo de trabajo de renderizado.

Puerta: npx hyperframes check pasa sin errores dentro de <output-dir>/composition/ (la única puerta del navegador antes del renderizado — consulta hyperframes-cli para ver qué audita).


Paso 4: Validar, renderizar y entregar

Lee: references/step-4-deliver.md

Valida, previsualiza, renderiza en <output-dir>/showfolio.mp4, elige el mejor fotograma de póster en <output-dir>/showfolio.jpg, hornea ese póster como fotograma 0 del vídeo para que sea la miniatura inactiva en todas partes, y escribe <output-dir>/share-copy.txt.

Puerta: <output-dir>/showfolio.mp4 existe. Se ha elegido un póster con el mejor fotograma <output-dir>/showfolio.jpg (no un fotograma arbitrario) y se ha horneado como fotograma 0 de showfolio.mp4. El texto para compartir está escrito. No aparece ninguna credencial en ningún archivo o fotograma de salida.


Sistema de tonos

Siete predefinidos de tono vienen con /showfolio. Cada uno cambia la energía del guion, el ritmo, la personalidad tipográfica y el estilo de transición. Los predefinidos son valores por defecto, no límites.

Definiciones completas: references/tones.md

TonoEnergíaFrase resumen
defaultJuguetón, limpio, publicableEl valor por defecto de buenas vibras
polishedSerio, elegantePara proyectos que no son una broma
yc-parodyEnergía startup inexpresivaSeriedad falsa aplicada a proyectos absurdos
chaoticRápido, ruidoso, agresivoExagerado y desquiciado
deadpanTranquilo, seco, sobrioEl chiste es que nada es un chiste
cinematicDramático, escala de tráilerGran movimiento, afirmaciones más grandes
app-storeSuave, limpio estilo ficha de funciónCorporativo pero no aburrido

Permite siempre una dirección creativa libre para refinar o anular el predefinido.


Leyes creativas

Estas se aplican a cada vídeo showfolio independientemente del tono.

Marco Octacer, producto real. Las pantallas del producto permanecen exactamente como son. Todo lo que las rodea utiliza la marca Octacer (Ink #040408, White, Lime #A3DC2F como color principal; Space Grotesk, Montserrat, JetBrains Mono; el logotipo SVG, nunca escrito). Abre con el logotipo animado de Octacer, cierra con "Built by Octacer". Consulta references/brand.md.

La duración que el usuario pidió. Alcanza el objetivo del Paso 0 (aproximadamente 40, 60 o 90 segundos) con una tolerancia de ±10%. Llénalo con producto, no con relleno: más funciones y momentos más largos de la aplicación en funcionamiento, nunca pausas prolongadas en nada. Esto se cumple independientemente de si la narración está activada; la narración no extiende la ventana.

Destacar lo que pidieron. Cada página o función que el usuario nombró en el Paso 0 tiene su propia escena. La que marcaron como favorita recibe el mayor tiempo en pantalla y la mejor ubicación.

Vivo y rápido. 60 fps, movimientos de cámara rápidos de 0.5 a 0.8 s, sin desplazamientos lentos, algo nuevo cada 2–3 s, el cursor haciendo clic en la mayoría de las escenas del producto y escritura en tiempo real en cada chat o cuadro de entrada. Números completos: "Reglas de movimiento y ritmo" en references/step-2-plan.md.

Legible. Mantén el ritmo alto mediante movimiento y cortes, nunca mostrando texto fugazmente. Cada línea que un espectador debe leer permanece el tiempo suficiente para leerla (etiqueta corta ~0.8 s estable; una oración ~0.3 s por palabra). Entrada rápida, luego mantén — nunca entrada rápida, luego desaparece.

Específico. El vídeo debe parecer hecho para este proyecto exacto, no para cualquier proyecto. El propósito en una línea del usuario es la columna vertebral de la historia.

Muestra la cosa. La mayoría de las escenas muestran la interfaz de usuario real, el texto o una imagen clave del producto. Sin relleno abstracto.

Sin lenguaje SaaS genérico. "Optimiza tu flujo de trabajo" está prohibido. Usa el texto y las afirmaciones reales del proyecto.

El gancho lo es todo. Los primeros 2 segundos determinan si alguien sigue viendo. Planifica el gancho antes que cualquier otra cosa.

El humor gana su lugar. El humor debe provenir del absurdo del proyecto, no de intentar ser gracioso.

Patrón:

Picada de Octacer (1.5-2.5 s) → Gancho (3-5 s) → Propósito/revelación (4-8 s) → un segmento por función obligatoria a mostrar (6-15 s cada una; la favorita recibe la más larga) → Final con logotipo Octacer (3-5 s)

Adáptalo. Ajusta el tamaño de los segmentos de funciones para que el total llegue al objetivo. El patrón es una forma inicial, no una plantilla.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados