Communitygithub.com

ulasalyesil/personal-website-v2

Audita a superfície existente com base em decisões de camadas inferiores e produz um inventário de decisões de superfície — vocabulário, consistência de objetos, completude, feedback, hierarquia, acessibilidade

O que é personal-website-v2?

Este skill realiza uma auditoria detalhada e estruturada da camada de superfície de um produto — seja ele uma interface de tela, voz, dispositivo físico ou ponto de contato de serviço. Ele verifica se o que o usuário vê, ouve ou interage está alinhado com as decisões tomadas nas camadas inferiores, como o modelo conceitual e o fluxo de interação. O skill ajuda a identificar violações de vocabulário, inconsistências na representação de objetos, lacunas de completude em relação ao breadboard, desalinhamentos de registro emocional, problemas de acessibilidade e erros de hierarquia visual. Ele é dividido em duas partes principais: uma auditoria (fases 1 a 5) para avaliar o trabalho de superfície existente contra as decisões inferiores, e um inventário de decisões (fases 6 a 10) para mapear e resolver decisões abertas, gerando um relatório final com descobertas, decisões pendentes e recomendações de revisão em camadas inferiores. É focado em design de interação e experiência do usuário, mas não é específico de uma ferramenta de IA.

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

Perguntar na sua IA favorita

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

Documentação

/layers-surface

Assume que /layers-intro foi carregado para contexto do framework.

A camada de superfície é onde tudo o que foi decidido nas camadas abaixo se torna algo que uma pessoa realmente encontra: palavras, sons, visuais, affordances físicas, movimento, feedback. É a camada mais específica ao meio, mas as decisões mais importantes a serem tomadas primeiro são universais — elas se aplicam independentemente de a superfície ser uma tela, interface de voz, dispositivo físico ou ponto de contato de serviço.

As violações de superfície são frequentemente sintomas de problemas mais profundos. Este skill distingue entre problemas que você pode corrigir na superfície e problemas que exigem revisitar uma camada inferior.

Decisões que esta camada precisa tomar:

  • A superfície honra o vocabulário e os objetos do modelo conceitual?
  • Toda affordance do breadboard está presente — e há conteúdo de superfície sem nenhum modelo por trás?
  • A superfície transmite o registro emocional correto para os jobs que os usuários estão realizando?
  • Como o usuário sabe o que aconteceu, o que está em andamento e o que deu errado?
  • O que é mais proeminente, e deveria ser?
  • Cada peça de informação é acessível aos usuários que precisam dela?

Métodos:

MétodoQuando
Trabalhar diretamente no meio real (código, UI de produção)Quando você precisa de feedback real sobre interações reais. Evita a lacuna entre como algo parece em um mockup e como se comporta no uso.
Mockups de alta fidelidade (Figma, etc.)Explorar layout, hierarquia visual e forma visual — especialmente para padrões novos ou alinhamento de stakeholders.
Sistema de design / biblioteca de componentesQuando o produto possui componentes e tokens estabelecidos. As decisões de superfície devem estender o sistema, não contradizê-lo.
Style tilesEstabelecer a linguagem visual cedo sem se comprometer com o layout. Mais rápido que alta fidelidade para alinhamento inicial de tom.
ProtótiposTestar comportamento de interação — transições, tempo de feedback, fluxo — que mockups estáticos não conseguem transmitir.
Copy-firstQuando a linguagem é o principal material de design — mensagens, onboarding, estados de erro. Escreva o copy antes de projetar o contêiner.

Sinais de qualidade — como são boas decisões de superfície:

  • Cada termo corresponde à linguagem ubíqua do modelo conceitual
  • Cada objeto tem uma representação consistente entre contextos — não é um metamorfo, nem mascarado
  • Toda affordance do breadboard está presente; todo elemento de superfície tem um modelo por trás
  • O registro emocional corresponde aos jobs emocionais e sociais das necessidades do usuário
  • Mensagens de erro fazem três coisas: diagnosticar (o que aconteceu), explicar (por que), recuperar (o que fazer a seguir). "Algo deu errado" falha em todas as três.
  • A proeminência reflete a importância — o que o fluxo precisa que o usuário perceba é o que se destaca
  • Decisões de acessibilidade são tomadas explicitamente, não deixadas como padrão

Sessão guiada

Este skill tem duas partes. Diga-me o que você precisa:

  • Auditoria — avaliar o trabalho de superfície existente com base em decisões de camadas inferiores (Fases 1–5)
  • Inventário de decisões — trabalhar nas decisões abertas de superfície (Fases 6–10)

Descreva o que você tem, ou diga "guia-me" para começar.

Pergunte: "Onde devo capturar o trabalho desta sessão?" (veja /layers-intro para opções)

Pergunte:

  1. Em que produto ou funcionalidade estamos trabalhando?
  2. Qual meio — UI de tela, voz/conversacional, físico, pontos de contato de serviço?
  3. O que você tem das camadas inferiores? Modelo conceitual (objetos + linguagem ubíqua)? Breadboard ou fluxo? Job stories incluindo jobs emocionais/sociais?

Parte 1 — Auditoria

Fase 1 — Enquadrar a superfície

Existe trabalho de superfície existente — código funcional, UI implantada, copy, designs visuais? Ou a superfície ainda não foi iniciada? Se ainda não foi iniciada, pule para a Parte 2.

Fase 2 — Vocabulário e linguagem

Pegue a lista de linguagem ubíqua do modelo conceitual. Peça ao designer para compartilhar o copy da superfície — rótulos, cabeçalhos, texto de botões, mensagens de erro, notificações, texto de ajuda.

Verifique cada termo. Sinalize:

  • Violações diretas — um termo do modelo usado incorretamente ou de forma inconsistente ("Conta" em um lugar, "Espaço de trabalho" em outro)
  • Termos não listados — palavras na superfície que não estão na linguagem ubíqua. Novos termos para adicionar ao modelo, ou ruído de superfície?
  • Desalinhamentos de tom — tecnicamente correto, mas tonalmente errado para os jobs emocionais/sociais

Para cada violação: correção de superfície (reescrever o copy) ou correção mais profunda (atualizar o vocabulário do modelo conceitual)?

Fase 3 — Consistência de objetos

Para cada objeto no modelo conceitual: onde ele aparece na superfície? Em quantas formas?

  • Metamorfos — o mesmo objeto em formas visuais ou estruturais significativamente diferentes entre contextos
  • Objetos mascarados — o objeto aparece em uma forma onde um usuário não conseguiria reconhecê-lo como aquele tipo de objeto

Para cada um: isso é uma decisão de superfície (estabelecer um tratamento consistente) ou um problema do modelo conceitual (a identidade do objeto não está clara nem mesmo no modelo)?

Fase 4 — Verificação de completude

Pegue o breadboard. Para cada lugar e affordance:

  • Toda affordance do breadboard está presente na superfície?
  • Existe conteúdo de superfície sem nenhum elemento correspondente no breadboard?

Adições que não estavam no breadboard são frequentemente decisões da camada de interação que passaram despercebidas — sinalize-as e recomende revisitar /layers-interaction-flow.

Fase 5 — Registro emocional

Retorne às job stories, particularmente aos jobs emocionais e sociais.

"Qual job emocional o usuário está realizando aqui — não apenas a tarefa funcional, mas como ele quer se sentir?" "Qual job social está em jogo — como ele quer ser percebido?"

Desalinhamentos comuns:

  • A superfície enfatiza o benefício do produto ("nós ganhamos uma indicação") sobre o job do usuário ("eu ajudo um colega")
  • O copy enquadra uma interação de forma transacional quando o job do usuário é relacional
  • O tom parece especializado/clínico quando o usuário precisa se sentir seguro ou confiante

Parte 2 — Inventário de decisões

Fase 6 — Feedback e erros

Para cada ação significativa e transição de estado:

  • "Como o usuário sabe que sua ação funcionou?"
  • "Como o usuário sabe que algo está em andamento?"
  • "Como o usuário sabe que algo deu errado, e o que fazer sobre isso?"

Mensagens de erro devem diagnosticar, explicar e dizer ao usuário o que fazer a seguir. Sinalize todo estado de erro que não atenda a todos os três. Produza uma decisão para cada lacuna: "Precisamos decidir como comunicar [X] ao usuário. As opções são [Y]."

Fase 7 — Hierarquia e ênfase

Para cada lugar chave:

  • "Qual é a coisa mais importante que o usuário precisa notar ou agir aqui?"
  • "A superfície atual torna essa coisa a mais proeminente?"
  • "Algo é visualmente proeminente que não deveria ser?"

Estas são decisões agnósticas ao meio primeiro (o que deve ser primário) antes de se tornarem específicas ao meio (como torná-lo primário visualmente, auditivamente ou tátilmente).

Fase 8 — Acessibilidade

Sinalize considerações relevantes para o meio declarado:

  • UI de tela: contraste de cores, tamanho do texto, alvos de toque, navegação por teclado, rótulos de leitor de tela para elementos interativos e imagens, gerenciamento de foco entre etapas do fluxo
  • Voz/conversacional: todas as informações transmitidas verbalmente (sem "clique no botão à esquerda"), recuperação de erros sem contexto visual
  • Físico: alcance, diferenciação tátil, visibilidade em iluminação variada, operação sem precisão motora fina

Produza uma lista de decisões de acessibilidade: "Precisamos decidir como [X] será acessível para usuários que [Y]."

Fase 9 — Consistência

  • Coisas similares são tratadas de forma similar? (Mesmas ações parecem e se comportam da mesma forma; mesmos tipos de objeto representados consistentemente)
  • Coisas diferentes são tratadas de forma diferente? (Primário vs. secundário, destrutivo vs. seguro)
  • Esta superfície está em conformidade com as convenções de seu meio? Violar normas de plataforma é uma decisão com um custo — às vezes vale a pena, sempre intencional.

Distinga: inconsistências internas (corrigir dentro da superfície) vs. violações de convenção (escolha deliberada ou descuido — decida qual).

Fase 10 — Decisões abertas

Produza uma lista consolidada de todas as decisões de superfície que ainda precisam ser tomadas:

  • Questões entre camadas para resolver primeiro — raiz está em uma camada inferior; listadas separadamente; exigem revisitar o skill relevante antes que a superfície possa estar correta
  • Decisões de superfície para tomar agora — qual é a decisão? quais são as opções? quais restrições se aplicam (das camadas inferiores, do meio, da marca/consistência)?
  • Adiadas — não precisam ser tomadas agora, mas devem ser rastreadas

Conclusão

Produza:

  1. Descobertas da auditoria — violações de vocabulário, objetos mascarados/metamorfos, lacunas de completude, desalinhamentos de registro emocional — cada um categorizado como correção de superfície ou problema de camada mais profunda
  2. Inventário de decisões — todas as decisões abertas de superfície, agrupadas e priorizadas
  3. Questões entre camadas — coisas para resolver em uma camada inferior antes que a superfície possa estar correta
  4. O que está funcionando — decisões de superfície já tomadas corretamente; não as perca na revisão

Feche com: "A superfície é a camada que os usuários encontram. Tudo decidido abaixo ou é honrado aqui ou minado aqui. Revisite este skill após qualquer mudança significativa no modelo conceitual ou na estrutura de interação."

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

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

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

Habilidades Relacionadas