Communitygithub.com

KazmerMaximiliano/neus-ui

Gera um shell de página de marketing sem barra lateral — cabeçalho fixo, área de conteúdo principal, rodapé. Produz um layout .tsx para landing pages e páginas públicas. Sem AppTemplate.

O que é neus-ui?

Este skill automatiza a criação de um layout shell para landing pages e páginas públicas de marketing, gerando três arquivos TypeScript e CSS perfeitamente estruturados. Ele é acionado por comandos em português como "shell de landing", "layout de marketing" ou "header + footer layout", e é ideal para desenvolvedores que usam frameworks como React (Next.js ou similares) com a biblioteca de componentes neus-ui. O skill coleta dados essenciais do usuário (nome da marca, itens de navegação, CTA, cores, modo claro/escuro) e, em seguida, produz um componente LandingLayout que inclui cabeçalho fixo com efeito glass, área principal flexível e rodapé. Ele impõe regras rigorosas de qualidade, como a proibição de estilos inline, a obrigatoriedade de três arquivos (types, componente, CSS) e o uso exclusivo de componentes de neus-ui. O modo escuro e claro são tratados com receitas CSS específicas, garantindo uma experiência visual consistente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/KazmerMaximiliano/neus-ui/tree/HEAD/.agents/skills/neus-layout-landing

Perguntar na sua IA favorita

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

Documentação

Neus Layout Landing

Gera um shell de página pública: cabeçalho fixo + conteúdo principal + rodapé. Sem AppTemplate, sem barra lateral.

Antes de começar

A seção "Regras Compartilhadas" abaixo está sempre ativa. Além disso, leia:

  • .agents/skills/_shared/anti-slop.md — regras obrigatórias de qualidade
  • .agents/skills/_shared/prop-constraints.md — props proibidas e componentes inexistentes
  • .agents/skills/_shared/component-catalog.md — seções Button, Link
  • .agents/skills/_shared/theme-config.md — configuração do ThemeProvider
  • .agents/skills/_shared/checklist.md — portões P0/P1/P2
  • .agents/skills/_shared/dark-surfaces.md — receitas CSS para modo escuro (leia quando Modo: escuro)
  • .agents/skills/_shared/light-surfaces.md — receitas CSS para modo claro (leia quando Modo: claro)

Fase 0 — Coleta de Dados

Pergunte em texto livre:

  1. Nome da marca/produto (para o logotipo no cabeçalho)
  2. Itens de navegação do cabeçalho (links exatos)
  3. CTA do cabeçalho? (texto do botão — ex.: "Comece grátis")
  4. Rodapé: colunas de links ou apenas direitos autorais
  5. Cor primária do tema
  6. Modo do tema: claro ou escuro? (padrão: claro)

Fase 1 — Resolução Visual

Antes de escrever qualquer código, resolva a DIRETIVA VISUAL a partir das respostas da coleta.

  • Modo: escuro → leia dark-surfaces.md; use canvas escuro #0a0a14, navegação glass, superfícies glass
  • Modo: claro → leia light-surfaces.md; use canvas var(--color-white), navegação branca sólida

Declare a diretiva:

DIRETIVA VISUAL
  Modo: escuro | claro
  Arquivo de superfície: dark-surfaces.md | light-surfaces.md

Fase 2 — Gerar

Produza três arquivos nesta ordem: LandingLayout.types.ts → LandingLayout.tsx → LandingLayout.styles.css.

LandingLayout.types.ts

export type NavItem = {
  label: string;
  href: string;
};

export type LandingLayoutProps = {
  children: React.ReactNode;
};

LandingLayout.tsx

import { Button, Link, ThemeProvider } from 'neus-ui';
import './LandingLayout.styles.css';
import type { LandingLayoutProps } from './LandingLayout.types';

export const LandingLayout = ({ children }: LandingLayoutProps) => (
  <ThemeProvider initialTheme={{ primaryColor: '[hex da coleta]' }}>
    <div className="landing-layout">
      {/* Cabeçalho de navegação fixo */}
      <header className="landing-layout__header">
        <div className="landing-layout__header-inner">
          <span className="landing-layout__brand">[NomeDaMarca]</span>
          <nav className="landing-layout__nav">
            {/* Itens de navegação da coleta — type="primary" em fundo branco */}
            <Link label="[ItemNav1]" type="primary" href="#[seção]" />
          </nav>
          <Button label="[CTA do Cabeçalho]" variant="solid" color="primary" onClick={() => {}} />
        </div>
      </header>

      {/* Conteúdo da página */}
      <main className="landing-layout__main">
        {children}
      </main>

      {/* Rodapé */}
      <footer className="landing-layout__footer">
        <span>[NomeDaMarca] © {new Date().getFullYear()}</span>
        <div className="landing-layout__footer-links">
          <Link label="Termos" type="secondary" href="/terms" />
          <Link label="Privacidade" type="secondary" href="/privacy" />
        </div>
      </footer>
    </div>
  </ThemeProvider>
);

LandingLayout.styles.css

Aplique o Modo da DIRETIVA VISUAL. Use as receitas de superfície do arquivo de superfície resolvido.

Modo claro (Modo: claro):

.landing-layout { min-height: 100vh; display: flex; flex-direction: column; background: var(--color-white); }
.landing-layout__header {
  position: sticky;
  top: 0;
  z-index: 100;
  background: rgba(255, 255, 255, 0.85);
  backdrop-filter: blur(20px);
  -webkit-backdrop-filter: blur(20px);
  border-bottom: 1px solid var(--color-border-light);
}
.landing-layout__header-inner {
  max-width: 1200px;
  margin: 0 auto;
  padding: 1rem 2rem;
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: 2rem;
}
.landing-layout__brand {
  font-family: var(--font-display);
  font-size: 1.25rem;
  font-weight: 700;
  color: var(--color-primary);
}
.landing-layout__nav { display: flex; gap: 1.5rem; align-items: center; }
.landing-layout__main { flex: 1; }
.landing-layout__footer {
  padding: 1.5rem 2rem;
  display: flex;
  justify-content: space-between;
  align-items: center;
  border-top: 1px solid var(--color-border-light);
  font-size: 0.9rem;
  color: var(--color-gray-500);
}
.landing-layout__footer-links { display: flex; gap: 1rem; }

Modo escuro (Modo: escuro) — use em vez das regras do modo claro:

.landing-layout { min-height: 100vh; display: flex; flex-direction: column; background: #0a0a14; color: #e2e8f0; }
.landing-layout__header {
  position: sticky;
  top: 0;
  z-index: 100;
  background: rgba(10, 10, 20, 0.8);
  backdrop-filter: blur(20px);
  -webkit-backdrop-filter: blur(20px);
  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
}
/* (header-inner, brand, nav, main — iguais ao modo claro) */
.landing-layout__brand { color: #818cf8; }
.landing-layout__footer {
  padding: 1.5rem 2rem;
  display: flex;
  justify-content: space-between;
  align-items: center;
  border-top: 1px solid rgba(255, 255, 255, 0.08);
  font-size: 0.9rem;
  color: #64748b;
}

Regras Compartilhadas (Incorporadas)

Estas regras estão sempre ativas. Elas se aplicam mesmo que os arquivos _shared/ não sejam lidos.

Saída — sempre três arquivos

Toda saída do skill: ComponentName.types.ts → ComponentName.tsx → ComponentName.styles.css. Sem estilos inline (style={{}}). Sem tags <style> dentro dos componentes. CSS apenas em .styles.css.

Imports

import { Button, Card, Input, Badge, Link, Select, Modal, DataTable } from 'neus-ui';

Nunca importe de caminhos internos como ../../components/Button/Button.

Types

Todas as declarações type / interface → ComponentName.types.ts. Nunca declare tipos em .tsx.

React 19 — Sem FormEvent

Nunca import { FormEvent } from 'react'. Use <Button type="submit" onClick={...} /> no lugar.

Restrições de Props de Componentes

  • Button variant: "solid" | "outlined" | "text" — "ghost" NÃO existe
  • Button color: "primary" | "success" | "error" | "info" | "white" — "white" apenas para canvas escuro
  • Button size: "small" | "medium" | "large"
  • Card variant: "default" | "glass" — "glass" para canvas escuro
  • Badge color: "primary" | "success" | "error" | "info" | "neutral"
  • Link type: "primary" (marca) | "secondary" (cinza suave)
  • Select: sem prop required — valide externamente
  • FormTemplate: apenas children, submitLabel, loading — sem onSubmit/onCancel

Lista Negra de Slop

  • Sem estilos inline / style={{}} / tags <style>
  • Sem arrays de dados fixos quando os dados vêm de API — use props tipadas
  • Sem conteúdo inventado (depoimentos falsos, nomes placeholders, métricas falsas)
  • Sem tipo any do TypeScript
  • Sem <a>, <span>, <input>, <button> brutos quando existir um componente Neus UI
  • Sem font stacks fixos — use var(--font-display) / var(--font-mono)
  • No modo escuro: sem var(--color-primary-light) como fundo de seção; sem divs cartão brutas — use <Card variant="glass">

Individual skills in this repo

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

Habilidades Relacionadas