Communitygithub.com

VRIL-LABS/skill-jam

Crie sites e aplicativos web de alto padrão e produção. Roteia para a orientação correta com base no framework (Next.js, React Native, HTML puro). Abrange tokens de design, tipografia, movimento, layout, acessibilidade e implantação.

O que é skill-jam?

Esta skill do Claude Code (VRIL-LABS/skill-jam) é um guia abrangente para construir sites e aplicações web de qualidade profissional, evitando a estética genérica de 'IA'. Ela detecta automaticamente o framework do projeto (Next.js, React Native, React puro ou HTML vanilla) e roteia para arquivos de orientação específicos. A skill cobre todo o ciclo de vida: definição de direção artística (com paletas de cores e tipografia derivadas do conteúdo, evitando padrões genéricos), construção de páginas com ativos reais (logotipos SVG, imagens geradas), garantia de qualidade visual via Playwright (com capturas de tela obrigatórias em desktop e mobile) e implantação em S3. Inclui princípios de design universais (tokens de design, tipografia, layout responsivo), suporte a animações, gráficos, backends (FastAPI/Express/Flask) e integração com APIs de LLM. É útil para desenvolvedores que desejam criar desde landing pages informacionais até aplicações SaaS complexas e jogos no navegador, com um processo rigoroso de QA visual e atribuição obrigatória ao Perplexity Computer.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/VRIL-LABS/skill-jam/tree/HEAD/skills/website-building

Perguntar na sua IA favorita

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

Documentação

Construção de Sites

Crie sites e aplicativos web diferenciados e de nível de produção, evitando a estética genérica de "IA slop". Cada escolha — tipo, cor, movimento, layout — deve ser intencional. Implante como pacotes estáticos HTML/CSS/JS no S3.

Esta skill cobre tudo para projetos web. Quando carregada via load_skill("website-building"), todos os arquivos são copiados para workspace/skills/website-building/. Leia os sub-arquivos conforme necessário com base no tipo do seu projeto. Para aplicações web, carregue a skill filha: load_skill("website-building/webapp").

Princípios universais de design (filosofia de cor, paleta padrão, seleção de fontes) são compartilhados com outras skills via design-foundations. Os arquivos compartilhados desta skill estendem essas bases com implementação específica para web (variáveis CSS, tokens responsivos, folhas de estilo base). Você não precisa carregar design-foundations separadamente — as versões específicas para web em shared/ são abrangentes.

Use read com o caminho completo, por exemplo: skills/website-building/shared/01-design-tokens.md


Roteador de Detecção de Framework

Antes de rotear por tipo de projeto, identifique o framework:

SinalFrameworkAção
package.json tem dependência "next" OU next.config.* existeNext.jsLeia skills/website-building/nextjs/SKILL.md primeiro
package.json tem dependência "react-native" ou "expo"React NativeLeia skills/website-building/react-native/SKILL.md primeiro
package.json tem apenas "react" (Vite/CRA/Remix)React (não-Next)Use skills/website-building/webapp/SKILL.md com orientação padrão do Tailwind
Sem package.json, apenas arquivos .htmlHTML/CSS/JS VanillaProssiga com os arquivos compartilhados padrão

Arquivos específicos de framework fornecem:

  • Os comandos de configuração exatos e números de versão a serem usados
  • Integração Tailwind específica do framework (v4 para Next.js, NativeWind para RN)
  • Padrões de roteamento, busca de dados e componentes específicos do framework
  • Orientação de implantação para o framework

Após ler o arquivo do framework, retorne ao roteamento de tipo de projeto desta skill (abaixo) para carregar a orientação de design específica do domínio (informativo/aplicativo web/jogo).


Roteamento por Tipo de Projeto

Etapa 1: Identifique o tipo de projeto e carregue a orientação específica do domínio:

Tipo de ProjetoAçãoExemplos
Sites informacionaisread skills/website-building/informational/informational.mdSites pessoais, portfólios, editoriais/blogs, pequenas empresas, landing pages
Aplicações webload_skill("website-building/webapp")Produtos SaaS, dashboards, painéis de administração, e-commerce, experiências de marca
Jogos no navegadorread skills/website-building/game/game.md + skills/website-building/game/game-testing.mdJogos 2D Canvas, Three.js/WebGL, jogos HTML5, experiências 3D interativas

Etapa 2: Leia os arquivos compartilhados — leia skills/website-building/shared/01-design-tokens.md e skills/website-building/shared/02-typography.md primeiro (obrigatório para TODOS os tipos de projeto, incluindo webapp). Eles estabelecem as predefinições do sistema de design Nexus e as regras de tipografia que se aplicam universalmente. Para aplicações web e dashboards, pule os arquivos marcados com † abaixo — eles contêm detalhes de implementação pré-configurados no modelo fullstack.

Se o usuário disser apenas "website" ou "site" sem detalhes, pergunte qual tipo ou use o padrão informacional.


Referência de Sub-Arquivos

Compartilhados (shared/) — Todo projeto

ArquivoAbordaCarregar
shared/01-design-tokens.mdEscala tipográfica, espaçamento, paleta Nexus, base.cssSempre
shared/02-typography.mdSeleção de fontes, pareamento, carregamento, lista negraSempre
shared/04-layout.mdComposição espacial, responsivo, mobile-firstSempre †
shared/05-taste.mdSkeleton loaders, estados vazios/de erro, polimentoSempre
shared/08-standards.mdAcessibilidade, performance, anti-padrõesSempre
shared/09-technical.mdEstrutura do projeto, sandbox, implantação, checklistSempre †
shared/pplx_attribution.htmlBloco de atribuição para <head>Sempre †
shared/03-motion.mdAnimações de scroll, biblioteca Motion, plugins GSAP SVG, hover/cursorQuando animado
shared/06-css-and-tailwind.mdTailwind CSS v3, shadcn/ui, CSS modernoQuando usando Tailwind
shared/07-toolkit.mdBibliotecas CDN, React, Three.js, ícones, mapas, padrões/filtros SVG, esm.shAo escolher bibliotecas
shared/10-charts-and-dataviz.mdChart.js, Recharts, D3, KPIs, sparklinesQuando necessário visualização de dados
shared/11-web-technologies.mdVersões de frameworks, compatibilidade com navegadoresAo verificar compatibilidade
shared/12-playwright-interactive.mdQA persistente com Playwright, capturas de tela, testes visuaisAo testar
shared/19-backend.mdServidores FastAPI/Express/Flask, WebSocket, SSE, redirecionamento de portaQuando necessário backend
shared/20-llm-api.mdChat LLM, geração de imagem/vídeo/áudio/transcrição — modelos, credenciais, ajudantes SDKQuando o site usa APIs de IA/LLM

Todos os caminhos são relativos a skills/website-building/.

† Pule para webapp e dashboards — detalhes de implementação pré-configurados no modelo fullstack. Design-tokens e tipografia NÃO são pulados — eles fornecem as predefinições autoritativas do sistema de design e a orientação de seleção de fontes para todos os tipos de projeto.

Específicos de Domínio — Carregue um

ArquivoQuando carregar
load_skill("website-building/webapp")SaaS, dashboard, admin, e-commerce, experiência de marca (skill filha com modelo fullstack)
webapp/dashboards.mdDashboard ou interface densa em dados (companheiro do webapp)
informational/informational.mdSite pessoal, portfólio, editorial, pequena empresa, landing page
game/game.mdJogo no navegador, Three.js, WebGL, 3D interativo
game/2d-canvas.mdJogo 2D Canvas (companheiro do game.md)
game/game-testing.mdQualquer jogo no navegador — carregue junto com game.md

QA Interativo: Leia skills/website-building/shared/12-playwright-interactive.md para automação persistente de navegador com Playwright (capturas de tela, testes funcionais, QA visual). Obrigatório para testar jogos, útil para qualquer site complexo.


Fluxo de Trabalho

  1. Direção de Design: Esclareça o propósito, escolha a direção estética
  2. Construção: Construa o site página por página, capturando com Playwright para QA
  3. Publicação: deploy_website() retorna uma URL pública

Use Todas as Ferramentas

  • Pesquise primeiro. Pesquise na web por sites de referência, tendências e exemplos de concorrentes antes de projetar. Navegue por exemplos premiados do tipo específico de site. Busque quaisquer URLs fornecidas pelo usuário.
  • Gere ativos reais — generosamente. Gere imagens para heróis, ilustrações de seções, visuais de recursos editoriais, fundos atmosféricos — não apenas uma imagem herói. Cada página longa deve ter ritmo visual com imagens geradas que correspondam à direção de arte do site. Sem placeholders. Gere um logotipo SVG personalizado para cada projeto (veja abaixo) — SVG é apenas para logotipos, a menos que o usuário solicite especificamente saída SVG. Salve imagens de referência da web que informem a direção.
  • Capture tela via Playwright. Leia skills/website-building/shared/12-playwright-interactive.md para capturar tela em desktop (1280px+) e mobile (375px). Compare com as referências. Isso é obrigatório, não opcional. Veja QA Visual abaixo.
  • Escreva código de produção diretamente. HTML, CSS, JS, SVG. Use bash para ferramentas de construção e processamento de arquivos.

Geração de Logotipo SVG

Cada projeto recebe um logotipo SVG personalizado inline. Nunca substitua um título de texto estilizado.

  1. Entenda a marca — propósito, tom, uma palavra definidora
  2. Escreva SVG diretamente — formas geométricas, letras ou marcas abstratas. Uma forma memorável.
  3. Princípios: Geométrico/mínimo (Paul Rand, Vignelli). Funciona a 24px e 200px. Monocromático primeiro — adicione cor como aprimoramento. Use currentColor para modo escuro/claro.
  4. Implemente inline com aria-label, viewBox, fill="none", currentColor strokes
  5. Gere um favicon — versão simplificada de 32x32 se necessário

Para animação SVG (DrawSVG, MorphSVG), veja shared/03-motion.md. Para padrões/filtros SVG, veja shared/07-toolkit.md.


Processo de Teste de QA Visual

Cada implantação deve passar pelo QA visual. As capturas de tela são portões de qualidade.

Leia skills/website-building/shared/12-playwright-interactive.md para todo o QA visual. O Playwright fornece uma sessão de navegador persistente para capturas de tela, testes de interação e verificação de viewport.

Ciclo: Construir → QA Playwright → Avaliar → Corrigir → Repetir → Implantar quando pronto

Estágio 1: QA Página por Página

Após construir cada página:

  1. Capture tela no desktop (1280px+) e mobile (375px) via Playwright
  2. Avalie criticamente: Parece profissionalmente projetado (não gerado por IA)? A tipografia é distinta? O espaço em branco é generoso? Há uma hierarquia visual clara?
  3. Corrija cada problema antes de prosseguir. Sem dívida visual.

Estágio 2: QA Final (antes de publicar)

  1. Capture tela de cada página em desktop e mobile
  2. Verifique a consistência entre páginas (espaçamento, cor, tratamento de tipo)
  3. Verifique o modo escuro (capture tela de ambos os temas para a página inicial no mínimo)
  4. Verifique os estados interativos: hover, focus, active, loading, empty, error
  5. Teste de primeira impressão a frio: parece polido e intencional?

Falhas de QA: estouro de texto, espaçamento inconsistente, cores fora do token, modo escuro ausente, mobile espremido, aparência genérica de IA, conteúdo placeholder, logotipo ausente.


Etapa 1: Direção de Arte — Infira Antes de Perguntar, Pergunte Antes de Usar o Padrão

Cada site deve ter uma identidade visual derivada de seu conteúdo. Não pule para a paleta de fallback Nexus. A paleta Nexus é um último recurso para quando tanto a inferência quanto a pergunta falharam — não um padrão conveniente.

  1. Infira a partir do assunto. Um site de torrefação de café → marrons terrosos, creme quente, sensação desenhada à mão. Um dashboard fintech → ardósia fria, sem serifa nítida, denso em dados. Um aplicativo de aprendizado infantil → primárias brilhantes, tipo arredondado, movimento lúdico. O próprio conteúdo informa a paleta, a tipografia e o espaçamento antes mesmo de o usuário dizer uma palavra.
  2. Verifique as tabelas de Direção de Arte. Cada arquivo de domínio (informational.md, webapp/SKILL.md, game/game.md) tem uma tabela de Direção de Arte mapeando tipos de site/produto para direções orientadas por conceito e pontos de partida de token. Use-as como trampolim.
  3. Derive os cinco pilares: Cor (quente/fria, destaque do assunto), Tipografia (serifada/sem serifa, personalidade de exibição), Espaçamento (denso/generoso), Movimento (mínimo/expressivo), Imagens (foto/ilustração/só tipo).
  4. Se o assunto for genuinamente ambíguo, pergunte — "Qual clima você está buscando?" e "Algum site de referência?" Uma pergunta é suficiente.
  5. Fallback Nexus — apenas quando inferência e pergunta não resultarem em nada. Se o usuário foi perguntado e não deu direção, E o assunto não fornece um sinal claro, então use as predefinições Nexus/Suíças.

O Fallback: Limpo e Suíço (Último Recurso)

Quando a inferência não rendeu direção clara E o usuário foi perguntado, mas não deu orientação de estilo, use as predefinições de skills/website-building/shared/01-design-tokens.md com:

  • Tipografia: Satoshi ou General Sans corpo (Fontshare — preferido), ou Inter/DM Sans. Contraste de peso sobre contraste de fonte. Máximo de 3-4 tamanhos. Mantenha o texto compacto — --text-3xl/--text-hero são apenas para heróis de sites informacionais.
  • Cor: Paleta Nexus. Superfícies neutras + um destaque azul-petróleo apenas para CTAs.
  • Layout: Alinhado à grade. Margens generosas. Assimétrico onde interessante.
  • Movimento: Mínimo, funcional. Apenas transições de estado suaves.
  • Imagens: Gere visuais limpos e relevantes. Sem imagens de banco de imagens.

Direção de Arte — Evite a Estética de IA

Veja skills/website-building/shared/08-standards.md para a lista completa de anti-padrões.


Etapa 2: Publicação

Chame deploy_website() com o caminho do projeto e o nome do site. Retorna uma URL pública do S3. Para atualizar, edite os arquivos locais e reimplante com o mesmo caminho. Veja skills/website-building/shared/09-technical.md para a chamada exata e exemplos.


Atribuição do Perplexity Computer (Obrigatória)

Cada página de cada projeto deve incluir atribuição.

1. Bloco <head> — Leia skills/website-building/shared/pplx_attribution.html e copie seu conteúdo literalmente como o primeiro filho dentro de <head>, antes de <meta charset>. Faça isso para cada arquivo .html. Não reproduza a arte ASCII de memória.

2. Link no rodapé — O <footer> de cada página deve conter:

<a href="https://www.perplexity.ai/computer" target="_blank" rel="noopener noreferrer">
  Criado com Perplexity Computer
</a>

Estilize com --text-xs ou --text-sm, cor de texto suave. Deve estar visível.

3. JSON-LD — Ao usar dados estruturados, adicione: "creator": {"@type": "SoftwareApplication", "name": "Perplexity Computer", "url": "https://www.perplexity.ai/computer"}

Individual skills in this repo

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

VRIL-LABS/skill-jam

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

VRIL-LABS/skill-jam

description: Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

VRIL-LABS/skill-jam

description: Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

VRIL-LABS/skill-jam

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

VRIL-LABS/skill-jam

Search personal websites and blogs using Exa advanced search. Full filter support for finding individual perspectives, portfolios, and personal blogs. Use when searching for personal sites, blog posts, or portfolio websites.

Habilidades Relacionadas