Communitygithub.com

xoai/sage

Princípios universais de desenvolvimento web — acessibilidade (WCAG 2.2), desempenho (Core Web Vitals), cabeçalhos de segurança (OWASP), SEO, design responsivo, UX de erros e estados de carregamento. Independente de framework.

O que é sage?

Este skill, chamado 'sage' do pacote xoai, fornece um conjunto de princípios fundamentais de desenvolvimento web que se aplicam a qualquer projeto web, independente do framework utilizado (React, Vue, Svelte, JavaScript puro, etc.). Ele aborda tópicos essenciais como acessibilidade (WCAG 2.2), desempenho (Core Web Vitals), segurança (OWASP), SEO, design responsivo, experiência do usuário em erros e estados de carregamento. O objetivo principal do skill é garantir que agentes de IA apliquem consistentemente essas boas práticas, evitando erros comuns como omitir textos alternativos, causar mudanças de layout ou esquecer cabeçalhos de segurança. Ele é formado por 7 padrões, 6 antipadrões e 7 princípios, com base em fontes oficiais como W3C, Google e OWASP.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xoai/sage/tree/HEAD/skills/web

Perguntar na sua IA favorita

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

Documentação

web

Camada 1 — Fundação do Domínio (v2.0)

Princípios universais de desenvolvimento web que se aplicam a todo projeto web, independentemente do framework. React, Vue, Svelte, JS puro — esses princípios são válidos.

Filosofia

Este pacote codifica o conhecimento fundamental da plataforma web que agentes frequentemente acertam isoladamente, mas erram na prática. Um agente sabe o que são rótulos ARIA. Ainda assim, produz um formulário sem anúncios de erro para leitores de tela. Um agente sabe sobre Core Web Vitals. Ainda assim, renderiza uma imagem herói de 2 MB sem dimensões.

A lacuna não é conhecimento — é aplicação consistente.

O que está incluído

TipoQuantidadeCobertura
Padrões7Acessibilidade (WCAG 2.2), desempenho (Core Web Vitals), cabeçalhos de segurança (OWASP), SEO, design responsivo, UX de erros, estados de carregamento
Antipadrões6Sopa de divs, texto alternativo ausente, mudança de layout, formulários sem proteção, caminhos críticos apenas do lado do cliente, ausência de cabeçalhos de segurança
Constituição7princípios

Baseado em: W3C WCAG 2.2 (Outubro de 2023), Google Core Web Vitals (2025), OWASP Secure Headers Project, OWASP CSP Cheat Sheet, MDN Web Docs, Web Almanac 2025, European Accessibility Act (Junho de 2025).

O que este pacote NÃO cobre

  • Padrões específicos de framework (consulte react, nextjs, etc.)
  • Opiniões de metodologia CSS (BEM vs utility-first vs CSS-in-JS)
  • Configuração de ferramentas de build (Webpack, Vite, Turbopack)
  • Padrões de backend/API (consulte api ou baas)

Habilidades Relacionadas