Communitygithub.com

Hasnan42/Showfolio

Transforme um projeto Octacer (diretório ou URL de site) em um vídeo de showcase polido e com a marca Octacer (cerca de 40, 60 ou 90 segundos) com música, movimento e texto para compartilhar. As telas reais do projeto permanecem como estão; a introdução, títulos, fundos e encerramento usam a marca Octacer com um logotipo animado.

O que é Showfolio?

Showfolio-slim é uma skill de IA agêntica que cria vídeos de showcase profissionais para projetos Octacer diretamente na máquina do usuário, usando apenas ferramentas já disponíveis. Ela aceita como entrada um diretório de projeto local ou uma URL de site, inspeciona o código ou a página ao vivo, e gera um vídeo completo com storyboard, animações, áudio e renderização. A saída segue rigorosamente a identidade visual Octacer (paleta de cores, tipografia Space Grotesk/Montserrat/JetBrains Mono, logotipo SVG) sem misturar com as telas reais do produto, que permanecem intactas. A skill é ativada por comandos como '/showfolio-slim', 'vamos /showfolio isto' ou 'mostrar um site', e faz três perguntas iniciais sobre duração, funcionalidades a destacar e propósito do projeto. Para aplicações com login, ela solicita credenciais de teste ou reconstrói telas autenticadas a partir do código. Dados pessoais reais são ocultados com desfoque gaussiano (8–12px). Toda a saída é salva em 'showfolio-output/' com arquivos intermediários em 'work/'. Não depende de pacotes externos; a própria IA modelo constrói tudo com as ferramentas do sistema.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

/showfolio-slim

Você construiu. Agora mostre. Você faz o vídeo inteiro — história, visuais, áudio, render — com as ferramentas que estão na máquina.

Seja qual for o tom, deve parecer um vídeo de showcase moderno, elegante e polido: nada na tela ou na trilha sonora que não mereça seu lugar. Cada vídeo apresenta um projeto construído pela Octacer (veja "Marca Octacer" abaixo).

Uso: /showfolio-slim [entrada] [opções]. Opções (flags ou linguagem natural):

OpçãoPadrão
--tone <preset ou livre>inferido; default se nada se encaixar claramente
`--format landscapevertical
--duration <s>perguntado no passo 0 (cerca de 40, 60 ou 90s)

Escreva os entregáveis em showfolio-output/ no diretório atual (com timestamp showfolio-output-YYYY-MM-DD-HHmmss/ se já existir). Mantenha todos os arquivos intermediários (frames, downloads, scripts, stems) em uma subpasta work/ dentro dele.

0. Coleta

Antes de qualquer outra coisa, faça três perguntas ao usuário em uma mensagem e aguarde as respostas. Você pode dar uma olhada na lista de rotas ou páginas primeiro para que a pergunta 2 possa oferecer escolhas reais. Pule qualquer pergunta que já tenha sido respondida na invocação.

  1. Duração: quanto tempo o vídeo deve ter? ~40s, ~60s, ~90s ou um número próprio. Se não responder, use 60s e avise.
  2. O que destacar: quais recursos ou páginas devem aparecer no vídeo? Liste os principais que você encontrou. Peça para marcarem aquele de que mais se orgulham; ele terá mais tempo de tela.
  3. Propósito: em uma linha, para que serve este projeto?

Cada item obrigatório ganha sua própria cena. O favorito recebe o segmento mais longo e o melhor posicionamento. A linha de propósito é a espinha dorsal da história e do texto de compartilhamento. Se um recurso nomeado não existir no código, ou o propósito contradizer o que o código faz, avise.

Verificação de login. Em seguida, decida se as páginas a serem mostradas estão atrás de um login (rotas de login, middleware de autenticação ou guardas de rota, bibliotecas de autenticação como NextAuth, Clerk, Supabase, Firebase, Auth0, Passport, Devise). Se sim, obtenha credenciais de teste:

  1. O usuário já forneceu → use-as.
  2. Caso contrário, procure no repositório por uma conta demo ou de teste: README ou docs ("conta demo", "usuário de teste"), scripts de seed e fixtures, helpers de login de teste end-to-end, .env.example. Nunca abra arquivos .env reais, chaves ou pastas de segredos. Se encontrar, informe ao usuário qual conta e onde, e confirme que é uma conta de teste segura.
  3. Nada encontrado → peça ao usuário uma conta de teste e a URL onde o app roda (local ou staging), e avise que será usada apenas para fazer login e capturar telas.

Se preferir não compartilhar, reconstrua as telas logadas a partir do código com dados fictícios.

Se o app não puder ser acessado (nenhuma URL resolve, ou executá-lo localmente tocaria um banco de dados compartilhado ou de produção), não o execute. Use as capturas de tela reais já no repositório (docs, README, pastas de design) como a camada de produto, e ainda assim torne-as interativas. Digite em um campo de réplica colocado sobre o campo de entrada real de cada captura. Para estados de hover, levante uma cópia recortada do cartão ou botão sob o cursor. Deslize painéis e revele resultados como o app faria. Corte entre capturas consecutivas conforme os estados mudam. Informe ao usuário qual fonte você usou. As credenciais são usadas apenas na sessão do navegador headless. Passe-as por variáveis de ambiente, nunca as escreva em arquivo e nunca as mostre na tela. Uma tela de login no vídeo mostra um e-mail fictício e uma senha mascarada, e dados reais de usuário são tratados com a regra abaixo.

Desfoque, não descarte. Se uma tela importante mostrar dados pessoais reais (e-mails, nomes, números de telefone, avatares, registros de clientes), mantenha a tela e desfoque apenas esses pontos: um forte desfoque gaussiano (cerca de 8-12px em 1080p) sobre uma caixa ligeiramente maior que o texto, para que não possa ser lido mesmo com zoom. Descarte uma tela apenas quando os dados privados são o conteúdo e nada útil sobra após o desfoque. Desfoque os mesmos pontos em cada quadro, através de zooms e panorâmicas. Capturas de tela que já usam dados placeholder ou fictícios não precisam de desfoque.

1. Inspecionar

Primeiro, decida qual é a entrada, depois colete material dela. Apenas a fonte muda; tudo das perguntas abaixo em diante é o mesmo para toda entrada. Leia os recursos obrigatórios do passo 0 com mais atenção.

EntradaComo reconhecerDe onde vem o material
ProjetoNenhuma entrada fornecida, e o diretório atual é um projetoO código
SiteUma URL http(s)://, ou um domínio simples como exemplo.comO site ao vivo

Se a entrada não corresponder a nenhum tipo, ou não houver entrada e o diretório atual não for um projeto, pergunte ao usuário o que deve ser mostrado.

Projeto

Leia o código: a página principal, estilos (cores e fontes exatas), README, rotas e componentes principais. O melhor material é o produto em uso — encontre seus momentos: entrada → ação principal → resultado, para cada recurso obrigatório.

Você tem o código-fonte, então use-o diretamente: importe ou renderize os componentes reais do projeto, folhas de estilo, fontes, imagens e animações no vídeo em vez de reconstruí-los. Para páginas atrás de login, execute o app e faça login com as credenciais de teste do passo 0 para capturar as telas logadas reais.

Site

Obtenha o site como um visitante o vê. Muitos sites constroem sua página com JavaScript, então um download simples pode retornar uma casca quase vazia. Se isso acontecer, carregue a página em um navegador headless para obter o resultado renderizado. Dispense banners de cookies e outras sobreposições, e role seção por seção, já que conteúdo que anima ao rolar permanece em branco em uma única captura de página inteira. Faça login com as credenciais de teste do passo 0 para acessar páginas atrás de login.

  • Texto: título, subtítulo, cabeçalhos de seção, nomes de recursos, chamadas para ação, depoimentos. Verifique também o título, meta descrição e tags de preview social.
  • Identidade: cores exatas do CSS do site e as fontes que ele carrega.
  • Visuais: o logotipo, capturas de tela do produto, imagens de herói, vídeos demo. Baixe os que usará em work/.
  • Capturas de tela: capture a página na proporção do vídeo para entender o layout. No vídeo, reuse a marcação HTML, CSS e ativos reais do site e anime-os, em vez de panorâmicas sobre capturas estáticas.
  • O produto em uso: verifique os vídeos demo, seções de como funciona e documentação vinculada para o fluxo entrada → ação principal → resultado.

Em seguida, para toda entrada

Antes de planejar, responda: O que é (uma frase, começando pela linha de propósito do usuário)? Para quem é, e o que faz por eles? O que o diferencia? Qual é a afirmação mais impressionante ou engraçada? Qual é o gancho visual? Qual UI ou fluxo real mostra cada recurso obrigatório? Que tom se encaixa? Qual é a legenda de compartilhamento de uma linha?

Marca Octacer

O vídeo tem duas camadas que nunca se misturam. A camada de produto são as telas reais do projeto, UI, texto e dados, nas cores e fontes do projeto, inalteradas. O quadro Octacer é tudo ao redor e entre elas: fundos de palco, títulos, legendas, rótulos de recursos, transições, a introdução, o encerramento e o logotipo no canto.

  • Paleta (fechada): palco Ink #040408, painéis #0b0e14, bordas finas rgba(255,255,255,0.10), grade fina opcional rgba(255,255,255,0.05), Branco #FFFFFF para informações, Muted rgba(255,255,255,0.65) para rótulos, Lime #A3DC2F (brilhante #BBEF44) como o sinal. Nenhum outro matiz. Texto sobre lime é sempre #040408.
  • Lime significa algo: um estado ativo, um tique verificado, um pequeno ripple de clique, o segmento de recurso atual, um preenchimento de progresso. Sem caixas lime ao redor de coisas nas telas do produto; o cursor e o zoom fazem a indicação. Nunca use como decoração: sem brilhos, bolhas, pontos brilhantes ou lavagens.
  • Tipo: Space Grotesk negrito para títulos e nomes de recursos, Montserrat para corpo e legendas, JetBrains Mono MAIÚSCULO com tracking 0.14em para sobretítulos (RECURSO 02 · LEITOR DE DOCUMENTOS). Todos os três estão no Google Fonts. Se a skill /showfolio estiver instalada, seus assets/brand/fonts/ os têm auto-hospedados.
  • Logotipo: sempre este SVG. Nunca digite "octacer" em uma fonte, redesenhe, recolorir ou adicione efeitos. O caminho 1 é a marca lime, que também funciona como o "O". Os caminhos 2–7 são as letras C-T-A-C-E-R. Para o logotipo de canto, use apenas o caminho 1 com 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>
  • Vinheta de abertura (1,5–2,5s, conta para a duração): Palco Ink. A marca lime se desenha (pathLength="1", animar stroke-dashoffset 1→0). As letras então surgem ou aparecem, escalonadas 40–60ms cada. Segure por cerca de 0,5s, depois o gancho. Sem explosões, partículas ou brilho.
  • Segmentos de recursos: um sobretítulo e nome do recurso na tipografia do quadro. A tela real é reproduzida dentro de um quadro de navegador ou dispositivo na cor Panel com borda fina, centralizada sobre Ink. As legendas ficam fora da tela.
  • Logotipo de canto: a marca, canto inferior direito, cerca de 6–9% da largura com margem de cerca de 3% da largura, estável a 70–85% de opacidade, durante as cenas do produto.
  • Encerramento (3–5s): nome do projeto → logotipo Octacer completo → Built by Octacer (Montserrat Muted), com um octacer.com opcional em JetBrains Mono. Para uma chamada para ação, use apenas Map Your System.
  • O tom nunca muda o quadro: o tom define apenas o ritmo e a energia do texto. Sem tom fornecido, prefira polished ou app-store.
  • Nenhuma afirmação inventada da Octacer: sem nomes de clientes, números, prêmios ou depoimentos. Apenas "Built by Octacer", os fatos do próprio projeto e a linha de propósito do usuário.

2. Planejar

Escreva showfolio-plan.md: as respostas da coleta (duração, lista de obrigatórios com o favorito marcado, propósito e como o login foi tratado, nunca as credenciais), o ângulo, o gancho, um segmento por recurso obrigatório, a conclusão, tom, identidade visual e um storyboard cena a cena com durações que somem ao alvo.

Se o usuário apontar para uma parte — uma nova versão, um novo recurso, um ângulo — faça disso o foco do vídeo.

Forma: Vinheta Octacer (1,5–2,5s) → Gancho (3–5s) → Propósito/revelação (4–8s) → um segmento por recurso obrigatório (6–15s cada; o favorito leva o mais longo) → Encerramento com logotipo Octacer (3–5s). Uma forma inicial, não um modelo.

Leis criativas

  • Quadro Octacer, produto real. As telas do produto permanecem exatamente como são. Tudo ao redor delas é Octacer: paleta, fontes, o logotipo SVG, uma vinheta de logotipo no início e "Built by Octacer" no final.
  • A duração que o usuário pediu. Atingir o alvo do passo 0 dentro de ±10%. Preencha com produto, não com enchimento: mais do fluxo de cada recurso, nunca esperas mais longas em nada.
  • Destaque o que pediram. Cada item obrigatório tem sua própria cena; o favorito recebe mais tempo.
  • Claro para um estranho. Após uma visualização, alguém que nunca ouviu falar sabe o que faz, para quem é e como obtê-lo. Lidere com isso, não com como foi construído.
  • O gancho é tudo. Os primeiros 2 segundos decidem se alguém continua assistindo. Planeje-o primeiro.
  • Mostre a coisa. Reutilize a coisa real da fonte — sua UI, componentes, texto, imagens, vídeos e animações — em vez de recriá-la. Reconstrua apenas o que não puder reutilizar. Prefira o app funcionando fazendo seu trabalho a uma página de destino descrevendo-o. Texto ilustrativo pequeno de UI é aceitável ao mostrar o produto em uso (um nome de arquivo, um toast "Exportado"); afirmações, números ou depoimentos inventados não são. Nunca use preenchimento abstrato.
  • Específico. Deve parecer feito para este projeto exato. Use seu próprio texto e afirmações; sem linguagem genérica de SaaS ("otimize seu fluxo de trabalho" é proibido).
  • Legível. O ritmo vem do movimento e dos cortes, não de tirar o texto cedo. Qualquer linha que o espectador deve ler permanece totalmente visível e estabilizada tempo suficiente para ser lida (aproximadamente 0,3s por palavra), contado a partir do momento em que toda a linha está na tela. Texto que é apenas textura não precisa ser lido.
  • Torne-o vivo. Coisas que aparecem uma a uma...

... [O conteúdo foi truncado por questões de tamanho, mas a tradução segue o mesmo padrão para as seções restantes]

3. Produzir

Implemente o plano. Use as ferramentas disponíveis na máquina: qualquer editor de vídeo, ferramenta de animação, sintetizador de áudio, etc. O vídeo final deve estar em showfolio-output/ no formato e duração especificados.

4. Revisar

Assista ao vídeo renderizado. Verifique se:

  • A duração está dentro de ±10% do alvo.
  • Todos os recursos obrigatórios estão presentes.
  • O gancho está nos primeiros 2 segundos.
  • A identidade Octacer está correta.
  • Todos os dados pessoais estão desfocados conforme necessário.
  • O texto está legível.
  • O áudio está sincronizado.

Se algo estiver errado, corrija e renderize novamente.

5. Entregar

Forneça ao usuário:

  • O caminho para o vídeo final em showfolio-output/.
  • O texto de compartilhamento (uma linha) da etapa de planejamento.
  • Um resumo do que foi feito e como.

Não compartilhe credenciais ou dados sensíveis. Apenas o produto final e a história.

Individual skills in this repo

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

Habilidades Relacionadas