Communitygithub.com

Hasnan42/Showfolio

Convierte un proyecto de Octacer (directorio o URL del sitio web) en un video promocional pulido con la marca Octacer (de unos 40, 60 o 90 segundos) con música, movimiento y texto para compartir.

¿Qué es Showfolio?

Showfolio es una habilidad de agente de IA que genera automáticamente videos promocionales de estilo profesional para proyectos, utilizando activos reales del proyecto (código o sitio web en vivo). Está diseñado para agentes como Claude Code, Cursor o Codex, y se activa mediante frases como "/showfolio-slim" o "hacer un video promocional". El flujo de trabajo comienza con tres preguntas (duración, características a destacar y propósito), seguidas de una inspección del proyecto para extraer elementos visuales, diseño y flujos de usuario. Luego, la IA elabora un guion gráfico y renderiza el video respetando estrictas pautas de marca: una paleta de colores fija, tipografía y un logotipo SVG animado. Las pantallas reales del proyecto se conservan tal cual, mientras que los elementos circundantes (fondos, títulos, transiciones) usan el estilo de Octacer. La habilidad maneja el inicio de sesión mediante credenciales de prueba, difumina datos personales y admite formatos horizontal, vertical y cuadrado. El resultado se guarda en la carpeta `showfolio-output/`.

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

Preguntar en tu IA favorita

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

Documentación

/showfolio-slim

Lo creaste. Ahora muéstralo. Tú haces el video completo — historia, imágenes, audio, renderizado — con las herramientas que tengas en la máquina.

Sea cual sea el tono, debe sentirse como un video promocional moderno, elegante y pulido: nada en la pantalla o en la banda sonora que no se haya ganado su lugar. Cada video presenta un proyecto construido por Octacer (ver "Marco de marca Octacer" más abajo).

Uso: /showfolio-slim [entrada] [opciones]. Opciones (flags o lenguaje natural):

OpciónPor defecto
--tone <preajuste o libre>inferido; default si nada encaja claramente
--format landscape|vertical|squarelandscape (1920×1080; vertical 1080×1920, square 1080×1080), 60fps
--duration <s>preguntado en el paso 0 (unos 40, 60 o 90s)

Escribe los entregables en showfolio-output/ en el directorio actual (con marca de tiempo showfolio-output-YYYY-MM-DD-HHmmss/ si ya existe). Mantén todos los archivos intermedios (fotogramas, descargas, scripts, pistas) en una subcarpeta work/ dentro de ella.

0. Recopilación

Antes de cualquier otra cosa, haz al usuario tres preguntas en un mensaje y espera las respuestas. Puedes echar un vistazo a la ruta o lista de páginas primero para que la pregunta 2 pueda ofrecer opciones reales. Omite cualquier pregunta que la invocación ya haya respondido.

  1. Duración: ¿cuánto tiempo debería durar el video? ~40s, ~60s, ~90s, o su propio número. Si no responden, usa 60s y dilo.
  2. Qué destacar: ¿qué características o páginas deben aparecer en el video? Enumera las principales que encontraste. Pídeles que marquen la que más les enorgullece; esa tendrá la mayor duración en pantalla.
  3. Propósito: en una línea, ¿para qué sirve este proyecto?

Cada elemento que debe mostrarse tiene su propia escena. El favorito recibe el segmento más largo y la ubicación más destacada. La línea de propósito es la columna vertebral de la historia y el texto para compartir. Si una característica nombrada no existe en el código, o el propósito contradice lo que hace el código, dilo.

Verificación de inicio de sesión. Luego decide si las páginas a mostrar están detrás de un inicio de sesión (rutas de login, middleware de autenticación o guardias de ruta, librerías de autenticación como NextAuth, Clerk, Supabase, Firebase, Auth0, Passport, Devise). Si es así, obtén credenciales de prueba:

  1. El usuario ya las dio → úsalas.
  2. De lo contrario, busca en el repositorio una cuenta demo o de prueba: README o docs ("cuenta demo", "usuario de prueba"), scripts de seed y fixtures, ayudantes de login en pruebas de extremo a extremo, .env.example. Nunca abras archivos .env reales, claves o carpetas de secretos. Si encuentras una, dile al usuario qué cuenta y dónde, y confirma que es una cuenta de prueba segura.
  3. No se encuentra nada → pide al usuario una cuenta de prueba y la URL donde se ejecuta la aplicación (local o staging), y dile que solo se usará para iniciar sesión y capturar pantallas.

Si prefieren no compartir, reconstruye las pantallas con inicio de sesión a partir del código con datos ficticios.

Si no se puede acceder a la aplicación (ninguna URL resuelve, o ejecutarla localmente tocaría una base de datos compartida o de producción), no la ejecutes. Usa las capturas de pantalla reales que ya están en el repositorio (docs, README, carpetas de diseño) como capa del producto, y hazlas interactivas. Escribe en una entrada réplica colocada sobre el cuadro de entrada real de cada captura de pantalla. Para los estados de hover, levanta una copia recortada de la tarjeta o botón bajo el cursor. Desliza paneles y desvanece resultados como lo haría la aplicación. Corta entre capturas de pantalla consecutivas a medida que cambian los estados. Dile al usuario qué fuente usaste. Las credenciales se usan solo en la sesión del navegador sin interfaz gráfica. Pásalas a través de variables de entorno, nunca las escribas en ningún archivo, y nunca las muestres en pantalla. Una pantalla de inicio de sesión en el video muestra un correo electrónico ficticio y una contraseña enmascarada, y los datos de usuario reales se manejan con la regla siguiente.

Difumina, no elimines. Si una pantalla importante muestra datos personales reales (correos electrónicos, nombres, números de teléfono, avatares, registros de clientes), conserva la pantalla y difumina solo esos puntos: un fuerte desenfoque gaussiano (aproximadamente 8–12px a 1080p) sobre un cuadro ligeramente más grande que el texto, para que no se pueda leer incluso al hacer zoom. Elimina una pantalla solo cuando los datos privados sean el contenido y no quede nada útil después del desenfoque. Difumina los mismos puntos en cada fotograma, a través de zooms y paneos. Las capturas de pantalla que ya usan datos de marcador de posición o ficticios no necesitan desenfoque.

1. Inspección

Primero decide qué es la entrada, luego recopila material de ella. Solo cambia la fuente; todo lo demás, desde las preguntas a continuación en adelante, es igual para cada entrada. Lee las características que deben mostrarse del paso 0 con más atención.

EntradaCómo reconocerlaDe dónde proviene el material
ProyectoNo se da entrada, y el directorio actual es un proyectoEl código
Sitio webUna URL http(s)://, o un dominio desnudo como example.comEl sitio en vivo

Si la entrada no coincide con ningún tipo, o no hay entrada y el directorio actual no es un proyecto, pregunta al usuario qué mostrar.

Proyecto

Lee el código: la página principal, los estilos (colores y fuentes exactos), el README, las rutas y los componentes clave. El mejor material es el producto en uso — encuentra sus momentos: entrada → acción clave → resultado, para cada característica que debe mostrarse.

Tienes el código fuente, así que úsalo directamente: importa o renderiza los componentes reales del proyecto, las hojas de estilo, las fuentes, las imágenes y las animaciones en el video en lugar de reconstruirlos. Para páginas detrás de un inicio de sesión, ejecuta la aplicación e inicia sesión con las credenciales de prueba del paso 0 para capturar las pantallas reales con inicio de sesión.

Sitio web

Obtén el sitio como lo ve un visitante. Muchos sitios construyen su página con JavaScript, por lo que una descarga simple puede devolver una carcasa casi vacía. Si es así, carga la página en un navegador sin interfaz gráfica para obtener el resultado renderizado. Descarta los banners de cookies y otras superposiciones, y desplázate sección por sección, ya que el contenido que se anima al hacer scroll permanece en blanco en una captura de página completa única. Inicia sesión con las credenciales de prueba del paso 0 para acceder a las páginas detrás de un inicio de sesión.

  • Texto: titular, eslogan, encabezados de sección, nombres de características, llamadas a la acción, testimonios. También verifica el título, la meta descripción y las etiquetas de vista previa social.
  • Identidad: colores exactos del CSS del sitio y las fuentes que carga.
  • Visuales: el logotipo, capturas de pantalla del producto, imágenes de héroe, videos de demostración. Descarga los que usarás en work/.
  • Capturas de pantalla: captura la página en la relación de aspecto del video para entender el diseño. En el video, reutiliza el marcado, CSS y activos reales del sitio y anímalos, en lugar de hacer paneos sobre capturas de pantalla planas.
  • El producto en uso: revisa los videos de demostración, las secciones de cómo funciona y los documentos enlazados para el flujo de entrada → acción clave → resultado.

Luego, para cada entrada

Antes de planificar, responde: ¿Qué es (una oración, comenzando desde la línea de propósito del usuario)? ¿Para quién es y qué hace por ellos? ¿Qué lo diferencia? ¿Cuál es la afirmación más impresionante o divertida? ¿Cuál es el gancho visual? ¿Qué interfaz o flujo real muestra cada característica que debe mostrarse? ¿Qué tono encaja? ¿Cuál es el pie de foto de una línea para compartir?

Marco de marca Octacer

El video tiene dos capas que nunca se mezclan. La capa del producto son las pantallas reales del proyecto, la interfaz de usuario, el texto y los datos, en los colores y fuentes propios del proyecto, sin cambios. El marco Octacer es todo lo que las rodea y está entre ellas: fondos de escenario, títulos, pies de foto, etiquetas de características, transiciones, la introducción, el final y el logotipo en la esquina.

  • Paleta (cerrada): escenario Ink #040408, paneles #0b0e14, bordes finos rgba(255,255,255,0.10), cuadrícula fina opcional rgba(255,255,255,0.05), Blanco #FFFFFF para información, Atenuado rgba(255,255,255,0.65) para etiquetas, Lima #A3DC2F (brillante #BBEF44) como señal. Sin otros tonos. El texto sobre lima es siempre #040408.
  • Lima significa algo: un estado activo, una marca de verificación, una pequeña ondulación de clic, el segmento de característica actual, un relleno de progreso. Sin cajas lima alrededor de cosas en las pantallas del producto; el cursor y el zoom hacen la señalización. Nunca lo uses como decoración: sin resplandores, manchas, puntos brillantes o lavados.
  • Tipografía: Space Grotesk negrita para titulares y nombres de características, Montserrat para cuerpo y pies de foto, JetBrains Mono MAYÚSCULAS con tracking 0.14em para cejas (FEATURE 02 · DOCUMENT READER). Las tres están en Google Fonts. Si la habilidad /showfolio está instalada, su assets/brand/fonts/ las tiene autoalojadas.
  • Logotipo: siempre este SVG. Nunca escribas "octacer" en una fuente, lo redibujes, lo recolores o agregues efectos. La ruta 1 es la marca lima, que también hace las veces de "O". Las rutas 2–7 son las letras C-T-A-C-E-R. Para el logotipo de esquina, usa solo la ruta 1 con viewBox="0 0 29 28".
<svg width="170" height="28" viewBox="0 0 170 28" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M17.9411 26.5149C16.793 26.8285 15.5839 27 14.3328 27C11.9515 27 9.71789 26.3893 7.78272 25.3239L14.3328 8.39238L19.7575 25.8763C24.4208 23.8505 27.6733 19.2966 27.6733 14.0001C27.6733 6.82026 21.7005 1 14.3328 1C6.96495 1 0.992188 6.82032 0.992188 14.0001C0.992188 18.1696 3.00904 21.878 6.14118 24.2568" stroke="#A3DC2F" stroke-width="1.5" stroke-miterlimit="10"/>
<path d="M35.7461 13.9987C35.7461 6.79727 41.2824 1 49.0918 1C53.8214 1 57.9645 3.37658 60.0911 7.04919L58.3678 8.02135C56.6813 4.92475 53.1249 2.83627 49.0918 2.83627C42.3456 2.83627 37.6893 7.80533 37.6893 13.9986C37.6893 20.1917 42.3456 25.1607 49.0918 25.1607C53.1615 25.1607 56.7546 23.0362 58.4412 19.8676L60.1643 20.8399C58.0745 24.5486 53.8949 26.9971 49.0919 26.9971C41.2824 26.9974 35.7461 21.2002 35.7461 13.9987Z" fill="white"/>
<path d="M80.1452 2.80037H72.079V26.2051H70.0994V2.80037H62.0332V1H80.1452V2.80037Z" fill="white"/>
<path d="M97.1224 19.7958H84.2534L81.7602 26.2051H79.707L89.6796 1H91.7328L101.669 26.2051H99.6155L97.1224 19.7958ZM96.4259 17.9954L90.7062 3.34047L84.9867 17.9954H96.4259Z" fill="white"/>
<path d="M103.025 13.9987C103.025 6.79727 108.562 1 116.371 1C121.101 1 125.244 3.37658 127.37 7.04919L125.647 8.02135C123.961 4.92475 120.404 2.83627 116.371 2.83627C109.625 2.83627 104.969 7.80533 104.969 13.9986C104.969 20.1917 109.625 25.1607 116.371 25.1607C120.441 25.1607 124.034 23.0362 125.721 19.8676L127.444 20.8399C125.354 24.5486 121.174 26.9971 116.371 26.9971C108.562 26.9974 103.025 21.2002 103.025 13.9987Z" fill="white"/>
<path d="M146.801 24.4046V26.205H132.025V1H146.618V2.80037H133.969V12.5944H145.701V14.3948H133.969V24.4048L146.801 24.4046Z" fill="white"/>
<path d="M161.614 15.8708H153.511V26.205H151.568V1H161.688C165.867 1 169.277 4.34867 169.277 8.45347C169.277 11.8742 166.894 14.7548 163.631 15.6189L170.01 26.205H167.774L161.614 15.8708ZM153.511 14.0706H161.688C164.804 14.0706 167.334 11.5501 167.334 8.45347C167.334 5.32083 164.804 2.80037 161.688 2.80037H153.511V14.0706Z" fill="white"/>
</svg>
  • Intro (1.5–2.5s, cuenta para la duración): Escenario Ink. La marca lima se dibuja (pathLength="1", animar stroke-dashoffset 1→0). Las letras luego aparecen o se desvanecen, escalonadas 40–60ms cada una. Mantén aproximadamente 0.5s, luego el gancho. Sin destellos, partículas o brillos.
  • Segmentos de características: una ceja y nombre de característica en la tipografía del marco. La pantalla real se reproduce dentro de un marco de navegador o dispositivo de color Panel con un borde fino, centrado sobre Ink. Los pies de foto se colocan fuera de la pantalla.
  • Logotipo de esquina: la marca, abajo a la derecha, aproximadamente 6–9% del ancho con un margen de aproximadamente 3% del ancho, constante al 70–85% de opacidad, durante las escenas del producto.
  • Final (3–5s): nombre del proyecto → logotipo completo de Octacer → Built by Octacer (Montserrat atenuado), con un octacer.com opcional en JetBrains Mono. Para una llamada a la acción, usa solo Map Your System.
  • El tono nunca cambia el marco: el tono establece solo el ritmo y la energía del texto. Sin tono dado, prefiere polished o app-store.
  • Sin afirmaciones inventadas de Octacer: sin nombres de clientes, números, premios o testimonios. Solo "Built by Octacer", los hechos propios del proyecto y la línea de propósito del usuario.

2. Planificar

Escribe showfolio-plan.md: las respuestas de la recopilación (duración, lista de elementos que deben mostrarse con el favorito marcado, propósito y cómo se manejó el inicio de sesión, nunca las credenciales en sí), el enfoque, el gancho, un segmento por característica que debe mostrarse, el remate, el tono, la identidad visual y un guion gráfico escena por escena con duraciones que sumen el objetivo.

Si el usuario señala una parte — una nueva versión, una nueva característica, un enfoque — haz que esto sea el centro del video.

Forma: Intro de Octacer (1.5–2.5s) → Gancho (3–5s) → Propósito/revelación (4–8s) → un segmento por característica que debe mostrarse (6–15s cada uno; el favorito recibe el más largo) → Final con logotipo de Octacer (3–5s). Una forma inicial, no una plantilla.

Leyes creativas

  • Marco Octacer, producto real. Las pantallas del producto se mantienen exactamente como son. Todo lo que las rodea es Octacer: paleta, fuentes, el logotipo SVG, un intro de logotipo al principio y "Built by Octacer" al final.
  • La duración que el usuario pidió. Alcanza el objetivo del paso 0 dentro de ±10%. Llena con producto, no con relleno: más del flujo de cada característica, nunca mantener más tiempo sobre nada.
  • Destacar lo que pidieron. Cada elemento que debe mostrarse tiene su propia escena; el favorito recibe más tiempo.
  • Claro para un extraño. Después de una visualización, alguien que nunca ha oído hablar de él sabe qué hace, para quién es y cómo obtenerlo. Lidera con eso, no con cómo está construido.
  • El gancho lo es todo. Los primeros 2 segundos deciden si alguien sigue viendo. Planifícalo primero.
  • Muestra la cosa. Reutiliza lo real del código fuente — su interfaz de usuario, componentes, texto, imágenes, videos y animaciones — en lugar de recrearlo. Reconstruye solo lo que no puedas reutilizar. Prefiere la aplicación funcionando haciendo su trabajo sobre una página de aterrizaje describiéndolo. El texto pequeño ilustrativo de la interfaz de usuario está bien al mostrar el producto en uso (un nombre de archivo, un toast "Exportado"); las afirmaciones, números o testimonios inventados no lo están. Nunca uses relleno abstracto.
  • Específico. Debe sentirse hecho para este proyecto exacto. Usa su propio texto y afirmaciones; sin lenguaje genérico de SaaS ("optimiza tu flujo de trabajo" está prohibido).
  • Legible. El ritmo proviene del movimiento y los cortes, no de retirar el texto antes de tiempo. Cualquier línea que el espectador debe leer permanece completamente visible y estable el tiempo suficiente para leerla (aproximadamente 0.3s por palabra), contado desde que toda la línea está en pantalla. El texto que es solo textura no necesita ser leído.
  • Hazlo vivo. Las cosas que aparecen una por una tienen un ritmo. El cursor y el zoom señalan lo que es importante; las flechas y las cajas lima son solo para interacción directa. El texto y la interfaz de usuario no flotan, se deslizan desde un borde. Los botones se hunden brevemente al hacer clic; las tarjetas se elevan al pasar el ratón antes de que se haga clic en ellas. La combinación de colores del producto siempre está presente; el fondo de Octacer nunca la anula — ajusta la posición o escalona las pantallas para que todo encaje.
  • Sin sonido de teclado genérico. La banda sonora es licenciable, no una pista de demostración. El audio de la interfaz de usuario (clics, tonos de éxito, whooshes de transición) es opcional y no está predefinido.
  • Sin iconos Octacer genéricos. Los íconos y las ilustraciones son del producto o de un juego de íconos abierto apropiado, no una colección Octacer inventada.
  • Sin garabatos. Sin elementos dibujados a mano, sin estilos de boceto, sin líneas onduladas. Los trazos del cursor tienen bordes nítidos y son de color lima.

3. Construir

Con el guion gráfico como plano, construye el video. El marcado y los activos generados son para tu propio motor; el producto real en sí (componentes renderizados, hojas de estilo, fuentes, imágenes, animaciones) se importa directamente del proyecto. Si una biblioteca está disponible en el entorno, úsala; de lo contrario, usa SVG con transiciones CSS o marcos de video renderizados. La banda sonora es una sola pista — licenciable, sin derechos de autor, en capas — descargada de la biblioteca de audio del sistema o de un servicio gratuito como Pixabay o Freesound, nunca sintetizada ni compuesta.

Poner en escena

  • Fondo: Escenario Ink. Un panel de color Panel centrado, ligeramente más ancho que la pantalla del producto. Un borde fino, sin sombra. La cuadrícula fina opcional solo para escenas de producto.
  • Pantalla del producto: renderizada dentro del panel. Sin sombras de cuadro, sin reflejos.
  • Texto: cejas (JetBrains Mono, mayúsculas, tracking 0.14em), nombre de característica (Space Grotesk, blanco), cuerpo (Montserrat, atenuado, tamaño de letra más pequeño). Cada texto aparece escalonado. El texto permanece visible el tiempo suficiente para leerlo.
  • Cursor: un círculo lima pequeño y nítido (r=4 aproximadamente) cuando se desplaza sobre la interfaz de usuario; se vuelve un poco más grande después del clic. Aparece solo cuando se mueve; no flota.
  • Zoom: suave, hacia los elementos en los que se hace clic o las tarjetas sobre las que se pasa el ratón. la escala máxima es 2x en 1080p.

Capturar (solo sitio web)

Captura en la relación de aspecto del video. Guarda los fotogramas sin comprimir, limpia. Captura la página en una ventana gráfica lo suficientemente ancha para que quepa: 1440px o más para landscape, 800px o menos para vertical. Las capturas de pantalla en reposo (sin animación) se capturan como imágenes; las animaciones e interacciones se capturan como video. El marcado HTML renderizado y los estilos se reutilizan directamente del navegador sin cabeza en lugar de panear o hacer zoom sobre capturas de pantalla.

Renderizar

Todos los formatos: 60fps, fotogramas sin comprimir o con pérdida mínima. Usa ffmpeg o las bibliotecas de Python equivalentes. Combina la pista de audio descargada en el paso 3. Sin renderizar más de lo que pide el guion gráfico; si el video es más corto, es mejor que más largo. Sin reinicios de tiempo de inactividad: un renderizado fallido vuelve a intentar con el mismo comando; no uses una GPU a menos que el nvidia-smi muestre memoria libre.

Verificar

Reproduce el video renderizado y comprueba:

  • Gancho: los primeros 2 segundos enganchan.
  • Claro: un extraño entiende el producto y su propósito en una visualización.
  • Específico: el texto y los elementos visuales son del proyecto, no genéricos.
  • Legible: el texto permanece visible el tiempo suficiente para leerlo.
  • Marca: la marca de esquina, la paleta, la tipografía, el SVG del logotipo y "Built by Octacer" están como se especifica.
  • Duración: dentro del ±10% del objetivo.
  • Renderizado: sin fotogramas perdidos, sincronización de audio, recortes.

4. Entregar

Copia el archivo de video renderizado desde la carpeta de trabajo a la carpeta de salida (sin marca de tiempo). Ponle nombre con el nombre del proyecto, el formato y la duración: MiProyecto-landscape-60s.mp4. Registra en showfolio-plan.md qué comandos se ejecutaron, qué se descargó y cualquier decisión manual.

Luego imprime:

Listo. Revisa el video en showfolio-output/MiProyecto-landscape-60s.mp4.

Texto para compartir: [la línea de propósito del usuario, pulida como titular de lanzamiento, ajustada al video].

Qué hacer a continuación: súbelo a YouTube / Vimeo, publícalo en LinkedIn / Twitter, incrústalo en el README del proyecto.

Individual skills in this repo

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

Skills relacionados