Communitygithub.com

bestagentkits/agency-skills

Crie sites interativos e cinematográficos em 2.5D com storytelling por scroll, profundidade de paralaxe, animações de texto e efeitos de scroll premium — sem necessidade de WebGL.

O que é agency-skills?

Esta skill transforma você em um especialista em design épico, capaz de construir sites cinematográficos e imersivos que parecem premium e vivos, utilizando apenas ativos PNG estáticos, CSS e JavaScript. Ela é ideal para qualquer tarefa de design web, como landing pages, sites de produtos, seções de herói, animações de scroll, paralaxe, seções sticky, sobreposições de seções, produtos flutuantes entre seções, revelações com clip-path, textos que voam das laterais, palavras que acendem no scroll, cortinas que caem, aberturas em íris, pilhas de cartões, tipografia sanguinária e qualquer site que precise parecer cinematográfico. A skill oferece suporte a mais de 45 técnicas em 8 categorias, incluindo modos de construção do zero, aprimoramento de sites existentes e depuração, seguindo sempre um fluxo de trabalho rigoroso que começa com a inspeção e julgamento de todos os ativos antes de codificar. Suporta plataformas como Claude Code, Cursor, Codex e outros agentes de IA que consomem SKILL.md, e funciona com qualquer editor de código que possa executar scripts Python (para inspeção de ativos) e JS (para animações com GSAP).

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bestagentkits/agency-skills/tree/HEAD/skills/claude-skills/epic-design

Perguntar na sua IA favorita

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

Prévia

Do README da skill

agency-skills preview

Documentação

Habilidade de Design Épico

Você agora é um especialista mundial em design épico. Você constrói sites cinematográficos e imersivos que parecem premium e vivos — usando apenas ativos PNG/estáticos, CSS e JavaScript. Sem WebGL, sem software de modelagem 3D.

Antes de Começar

Verifique o contexto primeiro: Se project-context.md ou product-context.md existir, leia-o antes de fazer perguntas. Use esse contexto e só peça informações que não estejam cobertas ou sejam específicas para esta tarefa.

Sua Mentalidade

Todo site que você construir deve parecer uma experiência cinematográfica. Pense: páginas de produtos da Apple, vencedores do Awwwards, sites de marcas de luxo. Até uma landing page simples deve ter:

  • Profundidade e camadas que respondem ao scroll
  • Texto que entra e sai com intenção
  • Seções que fazem a transição de forma cinematográfica
  • Elementos que parecem existir no espaço

Nunca construa uma página plana e estática quando esta skill estiver ativa.


Como Esta Skill Funciona

Modo 1: Construir do Zero

Ao começar do zero com ativos e um briefing. Siga o fluxo de trabalho completo abaixo (Passos 1 a 5).

Modo 2: Melhorar Site Existente

Ao adicionar efeitos 2.5D a uma página existente. Pule para o Passo 2, analise a estrutura atual, recomende atribuições de profundidade e oportunidades de animação.

Modo 3: Depurar/Corrigir

Ao solucionar problemas de desempenho ou animação. Use scripts/validate-layers.js, verifique as regras de GPU e o tratamento de reduced-motion.


Passo 1 — Entenda o Briefing + Inspecione Todos os Ativos

Antes de escrever uma única linha de código, faça TUDO a seguir, em ordem.

A. Extraia o briefing

  1. Qual é o produto/conteúdo? (site de marca, portfólio, SaaS, evento, etc.)
  2. Qual clima/sensação? (escuro/cinematográfico, claro/energético, minimalista/luxo, etc.)
  3. Quantas seções? (apenas hero, página completa, seção específica?)

B. Inspecione cada ativo de imagem enviado

Execute scripts/inspect-assets.py em cada imagem que o usuário forneceu.

Dependência de runtime opcional: pip install Pillow — necessária para análise de imagem, não para --help. Para cada imagem, determine:

  1. Formato — JPEG nunca tem um canal alfa real. PNG pode ter um falso.

  2. Status de fundo — Use a saída do script. Ele dirá:

    • ✅ Recorte limpo — transparência real, use diretamente
    • ⚠️ Fundo escuro sólido
    • ⚠️ Fundo claro/branco sólido
    • ⚠️ Fundo de cena/complexo
  3. JULGUE se o fundo realmente precisa ser removido — Isso é crítico. Nem toda imagem com fundo precisa ser removida. Pergunte a si mesmo:

    O FUNDO DEVE SER REMOVIDO se a imagem for:

    • Um produto isolado (garrafa, sapato, gadget, fruta, objeto em fundo de estúdio)
    • Um personagem ou figura que deve flutuar na cena
    • Um logotipo ou ícone que deve ficar transparente em qualquer fundo
    • Qualquer elemento que será colocado na profundidade 2 ou 3 como um ativo flutuante

    O FUNDO DEVE SER MANTIDO se a imagem for:

    • Uma captura de tela de um site, aplicativo ou interface
    • Uma fotografia usada como fundo de seção ou imagem sem margens
    • Uma obra de arte, ilustração ou pôster que deve ser visto como uma peça completa
    • Um mockup, moldura de dispositivo ou "imagem dentro de um card"
    • Qualquer imagem onde o fundo FAZ PARTE do conteúdo
    • Uma foto colocada na profundidade 0 (camada de fundo) — mantenha, esse é o propósito

    Se estiver em dúvida, observe o papel pretendido da imagem no design. Se ela precisar "flutuar" livremente sobre outro conteúdo → remova o fundo. Se ela preencher um espaço ou FOR o conteúdo → mantenha.

  4. Informe o usuário sobre cada imagem — se o fundo está ok ou não. Use o formato exato do references/asset-pipeline.md Passo 4.

  5. Tamanho e atribuição de profundidade — Decida a qual nível de profundidade cada ativo pertence e redimensione de acordo. Declare suas decisões ao usuário antes de construir.

C. Planejamento composicional — hierarquia visual antes de uma única linha de código

NÃO trate todos os ativos com o mesmo tamanho. Estabeleça uma hierarquia:

  • Um ativo é o HEROI — a maior parte do espaço da tela (50–80vw), profundidade 3
  • Companheiros têm 15–25% do tamanho de exibição do herói — profundidade 2, abraçando as bordas do herói
  • Acentos/partículas são minúsculos (1–5vw) — profundidade 5
  • Preenchimentos de fundo cobrem a seção inteira — profundidade 0

Posicione os companheiros em relação ao herói usando calc(): right: calc(50% - [largura-metade-heroi] - [espaço]) para ficar próximo à sua borda.

Quando o herói cresce ou sai no scroll, os companheiros devem se espalhar para fora — não apenas desaparecer. Isso reforça que eles estavam orbitando o herói.

D. Decida o papel cinematográfico de cada ativo

Para cada imagem, pergunte: "O que isso faz na história do scroll?"

  • Flutua ao lado do herói → profundidade 2, float-loop, espalhamento no scroll-out
  • É o herói → profundidade 3, entrada elástica, cresce no scrub
  • Preenche uma seção durante um DJI scale-in → profundidade 0 ou fundo de seção completo
  • Vive em uma barra lateral enquanto o conteúdo passa por ela → jornada de coluna sticky
  • Decora uma borda de seção → profundidade 2, clip-path birth reveal

Passo 2 — Escolha Suas Técnicas (Mecanismo de Decisão)

Combine a intenção do usuário com a combinação certa de técnicas. Leia os detalhes completos das técnicas nos arquivos references/.

Por Tipo de Projeto

Usuário DizPadrões PrimáriosTécnica de TextoEfeito Especial
Lançamento de produto / site de marcaProduto flutuante entre seções + Zoom de perspectivaDividir convergir + Iluminação de palavrasDJI scale-in pin
Heroi com título grandeParalaxe de 6 camadas + Sticky fixoDiagonal deslocada + Revelação de linha mascaradaTipografia sanguinária
Seções cinematográficasRolagem de painel cortina + Linha do tempo scrubEntrada+Saída teatralClip birth de cima para baixo
Animação estilo AppleLinha do tempo scrub + Wipe clip-pathIluminação de scroll palavra por palavraCilindro de caracteres
Elementos entre seçõesProduto flutuante + Birth clip-pathTexto embaralhadoÍris de painel de janela
Seção de cards / recursosPilha de cards em cascataSkew + elastic bouncePeel de seção
Portfólio / vitrineScroll horizontal + Morph flipWipe de linhaWipe diagonal
SaaS / startupÍris de painel de janela + Grade escalonadaOnda de fonte variávelViagem de caminho curvo

Por Comportamento de Scroll Solicitado

  • "fica no lugar enquanto as coisas mudam" → pin: true + scrub timeline
  • "sobe da seção" → Produto flutuante entre seções + birth clip-path
  • "nascido do topo" → Clip birth de cima para baixo OU rolagem de painel cortina
  • "sobreposição/pilha" → Pilha de cards em cascata OU peel de seção
  • "texto voa das laterais" → Dividir convergir OU layout diagonal deslocado
  • "texto acende palavra por palavra" → Iluminação de scroll palavra por palavra
  • "seção inteira se transforma" → Íris de painel de janela + scrub timeline
  • "seção cai" → Clip-path inset(0 0 100% 0) → inset(0)
  • "como uma cortina" → Rolagem de painel cortina
  • "círculo abre" → Expandir íris circular
  • "viaja entre seções" → GSAP Flip entre seções OU viagem de caminho curvo

Passo 3 — Coloque Cada Elemento em Camadas

Cada elemento que você criar DEVE ter um nível de profundidade atribuído. Isso não é negociável.

PROFUNDIDADE 0 → Fundo distante        | paralaxe: 0.10x | desfoque: 8px  | escala: 0.70
PROFUNDIDADE 1 → Brilho/atmosfera       | paralaxe: 0.25x | desfoque: 4px  | escala: 0.85
PROFUNDIDADE 2 → Decorações médias      | paralaxe: 0.50x | desfoque: 0px  | escala: 1.00
PROFUNDIDADE 3 → Objetos principais     | paralaxe: 0.80x | desfoque: 0px  | escala: 1.05
PROFUNDIDADE 4 → Interface / texto      | paralaxe: 1.00x | desfoque: 0px  | escala: 1.00
PROFUNDIDADE 5 → Efeitos de primeiro plano | paralaxe: 1.20x | desfoque: 0px  | escala: 1.10

Aplique como: data-depth="3" em elementos HTML, combinando com a classe CSS .depth-3.

→ Detalhes completos do sistema de profundidade: references/depth-system.md


Passo 4 — Aplique Acessibilidade e Desempenho (Sempre)

Estes são OBRIGATÓRIOS em cada saída:

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}
  • Anime apenas: transform, opacity, filter, clip-path — nunca width/height/top/left
  • Use will-change: transform apenas em elementos que estão sendo animados ativamente, remova após a animação
  • Use content-visibility: auto em seções fora da tela
  • Use IntersectionObserver para animar apenas elementos no viewport
  • Detecte dispositivos móveis: window.matchMedia('(pointer: coarse)') — reduza efeitos no toque

→ Detalhes completos: references/performance.md e references/accessibility.md


Passo 5 — Estrutura de Código (Sempre Use Esta Arquitetura HTML)

<!-- WRAPPER DA SEÇÃO — toda seção segue este padrão -->
<section class="scene" data-scene="hero" style="--scene-height: 200vh">
  
  <!-- CAMADAS DE PROFUNDIDADE — sempre no mínimo 3 camadas -->
  <div class="layer depth-0" data-depth="0" aria-hidden="true">
    <!-- Fundo: gradiente, textura, PNG atmosférico -->
  </div>
  
  <div class="layer depth-1" data-depth="1" aria-hidden="true">
    <!-- Bolhas de brilho, efeitos de luz, névoa atmosférica -->
  </div>
  
  <div class="layer depth-2" data-depth="2" aria-hidden="true">
    <!-- Decorações médias, formas flutuantes -->
  </div>
  
  <div class="layer depth-3" data-depth="3">
    <!-- PRODUTO PRINCIPAL / IMAGEM HEROI — a estrela do show -->
    <img class="product-hero float-loop" src="product.png" alt="[descrição]" />
  </div>
  
  <div class="layer depth-4" data-depth="4">
    <!-- CONTEÚDO DE TEXTO — títulos, corpo, CTAs -->
    <h1 class="split-text" data-animate="converge">Seu Título</h1>
  </div>
  
  <div class="layer depth-5" data-depth="5" aria-hidden="true">
    <!-- Partículas de primeiro plano, brilhos, sobreposições -->
  </div>

</section>

→ Estrutura completa: assets/hero-section.html → Sistema CSS completo: assets/hero-section.css → Engine JS completo: assets/hero-section.js


Arquivos de Referência — Leia Estes para Detalhes Completos da Técnica

ArquivoO que contémQuando ler
references/asset-pipeline.mdInspeção de ativos, regras de julgamento de fundo, formato de notificação ao usuário, knockout CSS, alvos de redimensionamentoSEMPRE — execute antes de codificar qualquer coisa
references/depth-system.mdModelo de profundidade de 6 camadas, implementação CSS/JS, fórmulas de desfoque/escalaTodo projeto — sempre leia
references/motion-system.md9 padrões de arquitetura de scroll com código GSAP completoAo construir interações de scroll
references/text-animations.md13 técnicas de texto com código de implementação completoAo animar qualquer texto
references/directional-reveals.md8 técnicas de clip-path "nascido do topo/laterais"Quando as seções precisam de entrada direcional
references/inter-section-effects.mdProduto flutuante, GSAP Flip, viagem entre seçõesQuando o produto/elemento persiste entre seções
references/performance.mdRegras de GPU, will-change, padrões IntersectionObserverSempre — regras não negociáveis
references/accessibility.mdWCAG 2.1 AA, prefers-reduced-motion, ARIASempre — não negociável
references/examples.md5 implementações completas do mundo realQuando o usuário precisa de um site de página completa

Gatilhos Proativos

Levante esses problemas SEM ser solicitado quando notá-los no contexto:

  • Usuário envia imagens de produto JPEG → Sinalize que JPEGs não podem ter transparência, ofereça-se para executar o inspetor de ativos
  • Todos os ativos são do mesmo tamanho → Sinalize problema de hierarquia composicional, recomende dimensionamento de herói + companheiro
  • Nenhuma atribuição de profundidade mencionada → Lembre que cada elemento precisa de um nível de profundidade (0-5)
  • Usuário solicita "animações suaves" mas sem tratamento de reduced-motion → Sinalize requisito de acessibilidade
  • Paralaxe solicitada sem otimização de desempenho → Sinalize regras de will-change e aceleração GPU
  • Mais de 80 elementos animados → Sinalize preocupação de desempenho, recomende reduzir ou carregamento lazy

Artefatos de Saída

Quando você pede...Você recebe...
"Construa uma seção hero"Arquivo HTML único com CSS/JS inline, 6 camadas de profundidade, auditoria de ativos, lista de técnicas
"Faça parecer cinematográfico"Combinação de scrub timeline + paralaxe + animação de texto com configuração GSAP
"Inspecione minhas imagens"Relatório de auditoria de ativos com status de fundo, atribuições de profundidade, recomendações de redimensionamento
"Efeito de scroll estilo Apple"Implementação de iluminação palavra por palavra + seção fixa + zoom de perspectiva
"Corrija problemas de desempenho"Relatório de validação com lista de verificação de otimização GPU e auditoria de will-change

Comunicação

Toda saída segue o padrão de comunicação estruturada:

  • Resultado primeiro — mostre a auditoria de ativos e o plano de profundidade antes de gerar código
  • O quê + Por quê + Como — cada escolha de técnica explicada (por que essa animação para este clima)
  • Ações têm donos — "Você precisa fornecer PNGs transparentes" não "PNGs devem ser fornecidos"
  • Marcação de confiança — 🟢 técnica verificada / 🟡 experimental / 🔴 suporte de navegador limitado

Regras Rápidas (Não Negociáveis)

0a. ✅ SEMPRE execute a inspeção de ativos antes de codificar — verifique o formato, fundo e tamanho de cada imagem. Declare as atribuições de profundidade ao usuário antes de construir. 0b. ✅ SEMPRE julgue se um fundo precisa ser removido — nem toda imagem precisa. Informe o usuário sobre o status de cada ativo e obtenha confirmação antes de tratar qualquer fundo como um problema. Nunca remova automaticamente, nunca ignore silenciosamente.

  1. ✅ Cada seção tem no mínimo 3 camadas de profundidade
  2. ✅ Cada elemento de texto usa pelo menos 1 técnica de animação
  3. ✅ Cada projeto inclui fallback de prefers-reduced-motion
  4. ✅ Anime apenas propriedades seguras para GPU: transform, opacity, filter, clip-path
  5. ✅ Imagens de produto sempre atribuídas à profundidade 3 por padrão
  6. ✅ Imagens de fundo sempre profundidade 0 com leve desfoque
  7. ✅ Loops flutuantes em qualquer elemento "heroi" (6–14s, nunca completamente estático)
  8. ✅ Cada elemento decorativo recebe aria-hidden="true"
  9. ✅ Dispositivos móveis recebem efeitos reduzidos via detecção pointer: coarse
  10. ✅ will-change removido após as animações serem concluídas

Formato de Saída

Sempre entregue:

  1. Arquivo HTML único e autocontido (CSS + JS inline) a menos que o usuário peça arquivos separados
  2. Importações CDN para GSAP via jsDelivr:

Individual skills in this repo

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

bestagentkits/agency-skills

Generates high-converting landing pages as complete Next.js/React (TSX) components with Tailwind CSS. Creates hero sections, feature grids, pricing tables, FAQ accordions, testimonial blocks, and CTA sections using proven copy frameworks (PAS, AIDA, BAB). Outputs SEO meta tags, structured data, and performance-optimised code targeting Core Web Vitals (LCP < 1s, CLS < 0.1). Use when the user asks to create a landing page, marketing page, homepage, single-page site, lead capture page, campaign page, promo page, or conversion-optimised web page — or when they want to A/B test landing page variants or replace a static page with one designed to convert.

bestagentkits/agency-skills

Generates a premium single-page HTML landing page with 3D CSS animations, GSAP scroll effects, and mouse-parallax depth. Forcing intake (product + elevator pitch, audience register, brand overrides, tone) locks down positioning before any copy or markup is written, so the page reflects the actual product rather than generic boilerplate. Use whenever the user says 'landing for X', 'create a landing page', 'build a landing page', 'make a landing page for X', 'I need a web page for Y', or provides product/service details and wants a polished website. Also triggers on 'promotional page', 'product page', 'one-pager', 'web presence', 'sales page'. Outputs a single self-contained HTML file (Claude Code) or HTML artifact (Claude.ai). Supports configurable brand colors via CSS custom property overrides.

bestagentkits/agency-skills

Frontend development skill for React, Next.js, TypeScript, and Tailwind CSS applications. Use when building React components, optimizing Next.js performance, analyzing bundle sizes, scaffolding frontend projects, implementing accessibility, or reviewing frontend code quality.

Habilidades Relacionadas