Communitygithub.com

ulasalyesil/personal-website-v2

Impõe uma linha de base UI opinativa para evitar a 'sujeira' de interface gerada por IA.

O que é personal-website-v2?

Esta skill define um conjunto rigoroso de regras de UI para agentes de IA como Claude Code, Cursor ou Codex, garantindo que as interfaces geradas sejam consistentes, acessíveis e com boa performance. Ela estabelece padrões para pilha tecnológica (Tailwind CSS, motion/react), componentes (primitivos acessíveis), interações (AlertDialog para ações destrutivas), animações (apenas props de compositor) e tipografia (text-balance, tabular-nums). A skill é acionada pelo comando `/baseline-ui` para aplicar as regras a qualquer conversa ou revisar um arquivo específico contra elas, listando violações e sugerindo correções concretas. Útil para times que desejam evitar interfaces genéricas, quebradas ou com baixa qualidade visual geradas por agentes, promovendo um padrão de qualidade consistente em projetos web baseados em React e Tailwind.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/baseline-ui

Perguntar na sua IA favorita

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

Documentação

UI de Linha de Base

Impõe uma linha de base UI opinativa para evitar a 'sujeira' de interface gerada por IA.

Como usar

  • /baseline-ui Aplica essas restrições a qualquer trabalho de UI nesta conversa.

  • /baseline-ui <arquivo> Revisa o arquivo contra todas as restrições abaixo e gera:

    • violações (cite a linha/trecho exato)
    • por que é importante (1 frase curta)
    • uma correção concreta (sugestão em nível de código)

Pilha

  • DEVE usar os padrões do Tailwind CSS, a menos que valores personalizados já existam ou sejam explicitamente solicitados
  • DEVE usar motion/react (anteriormente framer-motion) quando animação JavaScript for necessária
  • DEVE usar tw-animate-css para animações de entrada e microanimações no Tailwind CSS
  • DEVE usar o utilitário cn (clsx + tailwind-merge) para lógica de classes

Componentes

  • DEVE usar primitivos de componente acessíveis para qualquer coisa com comportamento de teclado ou foco (Base UI, React Aria, Radix)
  • DEVE usar primeiro os primitivos de componente existentes do projeto
  • NUNCA misturar sistemas de primitivos na mesma superfície de interação
  • DEVE preferir Base UI para novos primitivos, se for compatível com a pilha
  • DEVE adicionar um aria-label a botões somente com ícone
  • NUNCA reconstruir comportamento de teclado ou foco manualmente, a menos que seja explicitamente solicitado

Interação

  • DEVE usar um AlertDialog para ações destrutivas ou irreversíveis
  • DEVE usar esqueletos estruturais para estados de carregamento
  • NUNCA usar h-screen, use h-dvh
  • DEVE respeitar safe-area-inset para elementos fixos
  • DEVE mostrar erros próximos aonde a ação acontece
  • NUNCA bloquear colagem em elementos input ou textarea

Animação

  • NUNCA adicionar animação a menos que seja explicitamente solicitada
  • DEVE animar apenas props do compositor (transform, opacity)
  • NUNCA animar propriedades de layout (width, height, top, left, margin, padding)
  • DEVE evitar animar propriedades de pintura (background, color), exceto para pequenas partes locais da UI (texto, ícones)
  • DEVE usar ease-out na entrada
  • NUNCA exceder 200ms para feedback de interação
  • DEVE pausar animações em loop quando fora da tela
  • DEVE respeitar prefers-reduced-motion
  • NUNCA introduzir curvas de easing personalizadas, a menos que sejam explicitamente solicitadas
  • DEVE evitar animar imagens grandes ou superfícies em tela cheia

Tipografia

  • DEVE usar text-balance para títulos e text-pretty para corpo/parágrafos
  • DEVE usar tabular-nums para dados
  • DEVE usar truncate ou line-clamp para UI densa
  • NUNCA modificar letter-spacing (tracking-*) a menos que seja explicitamente solicitado

Layout

  • DEVE usar uma escala fixa de z-index (sem z-* arbitrário)
  • DEVE usar size-* para elementos quadrados em vez de w-* + h-*

Performance

  • NUNCA animar superfícies grandes com blur() ou backdrop-filter
  • NUNCA aplicar will-change fora de uma animação ativa
  • NUNCA usar useEffect para algo que possa ser expresso como lógica de renderização

Design

  • NUNCA usar gradientes a menos que sejam explicitamente solicitados
  • NUNCA usar roxo ou gradientes multicoloridos
  • NUNCA usar efeitos de brilho como principal recurso de destaque
  • DEVE usar a escala de sombra padrão do Tailwind CSS, a menos que seja explicitamente solicitado
  • DEVE fornecer aos estados vazios uma ação clara de próximo passo
  • DEVE limitar o uso de cor de destaque a uma por visualização
  • DEVE usar tema existente ou tokens de cor do Tailwind CSS antes de introduzir novos

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Habilidades Relacionadas