swiftui-wcag-accessibility-auditor
por ramzesenokswiftui-wcag-accessibility-auditor faz auditoria de código de funcionalidades SwiftUI para iOS com base em WCAG 2.2 nível A/AA e WCAG2Mobile, e devolve correções prontas para aplicar, com evidências, prioridades e verificações para usuário quando o comportamento não puder ser determinado só pelo código. Use para autenticação, formulários, configurações, controles personalizados e revisões de UX antes do merge.
Este skill tem nota 84/100, o que o torna uma boa opção para usuários do diretório que precisam de uma auditoria de acessibilidade SwiftUI baseada apenas em código, com rastreabilidade para WCAG 2.2 e remediação pronta para aplicar. O repositório traz detalhes operacionais suficientes para entender quando usar, como executar e que tipo de saída esperar, permitindo decidir pela instalação com segurança, mesmo sem comando de instalação ou automação executável.
- Bom gatilho de uso: o frontmatter deixa claro que o foco é auditoria de funcionalidades SwiftUI para iOS e cita casos de uso como autenticação, formulários, configurações e controles personalizados.
- O fluxo operacional é explícito: orienta a ler uma sequência definida de arquivos de referência, seguir um processo de auditoria apenas com código e retornar achados priorizados em Markdown, com verificações para usuário quando o código não for suficiente.
- Boa utilidade para agentes: as referências incluídas cobrem fluxo de trabalho, checklist, exemplos de API, verificações manuais de follow-up e um guia de remediação pronto para aplicar, reduzindo suposições tanto na detecção quanto nas correções.
- Não há comando de instalação nem scripts, então a adoção depende de seguir manualmente o SKILL.md e os arquivos de referência, em vez de acionar automação.
- O skill é propositalmente apenas de código e não valida comportamento em tempo real, saída de leitor de tela ou medições visuais; alguns achados continuarão marcados como 'Needs user verification'.
Visão geral da skill swiftui-wcag-accessibility-auditor
O que esta skill faz
A skill swiftui-wcag-accessibility-auditor audita código de features iOS em SwiftUI para acessibilidade com base em WCAG 2.2 Nível A/AA e na interpretação WCAG2Mobile, e devolve correções prontas para patch em um formato conciso, priorizado. Ela foi pensada para revisão de código-fonte, não para testes em runtime, então ajuda a identificar bloqueios prováveis, rastrear evidências e sinalizar o que precisa de verificação do usuário, em vez de adivinhar.
Quem deve usar
Use a swiftui-wcag-accessibility-auditor skill quando precisar de uma revisão de acessibilidade em SwiftUI para telas como autenticação, formulários, configurações, listas, controles personalizados ou fluxos modais. Ela é uma boa escolha para times que fazem auditoria de UX antes do merge, planejamento de correções ou revisão de regressões de acessibilidade no código do app.
O que a torna diferente
Ao contrário de um prompt genérico, esta skill coloca no centro a rastreabilidade WCAG e a remediação específica de SwiftUI. Ela é especialmente útil quando você precisa saber não só o que pode estar errado, mas o que mudar com o menor número de edições possíveis e quais achados podem ser comprovados no código versus quais exigem confirmação manual.
Como usar a skill swiftui-wcag-accessibility-auditor
Ordem de instalação e carregamento
Para swiftui-wcag-accessibility-auditor install, use o comando de instalação do repositório: npx skills add ramzesenok/iOS-Accessibility-Audit-Skill --skill swiftui-wcag-accessibility-auditor. Depois da instalação, leia primeiro references/ios-audit-workflow.md, depois references/ios-audit-checklist.md e, por fim, references/wcag2mobile-ios-reference.md, porque é esse enquadramento de padrões que orienta a auditoria.
Qual entrada gera os melhores resultados
O padrão de uso da swiftui-wcag-accessibility-auditor usage funciona melhor quando você fornece uma feature delimitada, o caminho da tela e o recorte de código a inspecionar. Exemplo: “Audite o fluxo de login em SwiftUI em AuthView.swift e nas views relacionadas para problemas de WCAG 2.2 A/AA, retorne correções P0/P1/P2 e marque como Needs user verification tudo o que não puder ser comprovado no código.” Inclua quaisquer controles personalizados, estados de erro ou navegação que a skill precise rastrear.
Fluxo de trabalho sugerido
Um guia prático para swiftui-wcag-accessibility-auditor guide é: definir o fluxo da feature, inspecionar a view de entrada e os estados subsequentes, identificar pontos semânticos e padrões de risco, e então mapear os achados para status e prioridade de correção. Se o código não comprovar comportamentos como saída do VoiceOver, ordem de foco ou contraste visual, a skill deve evitar afirmar aprovação e, em vez disso, solicitar uma verificação dirigida pelo usuário.
Arquivos para ler primeiro
Comece com SKILL.md e depois examine references/ios-audit-workflow.md, references/ios-audit-checklist.md, references/swiftui-remediation-guide.md, references/swiftui-manual-checklist.md e references/ios-accessibility-api-examples.md. Essa sequência ajuda a entender as regras de auditoria antes de pedir correções, o que melhora tanto a qualidade dos achados quanto a qualidade dos patches.
FAQ da skill swiftui-wcag-accessibility-auditor
Ela serve só para SwiftUI?
Sim, a swiftui-wcag-accessibility-auditor skill foi criada em torno de features nativas iOS em SwiftUI. Se a feature também incluir UIKit, detalhes de implementação híbrida ou ponte personalizada entre plataformas, a skill ainda pode ajudar, mas espere menos certeza e mais necessidade de verificação do usuário.
Em que ela é diferente de um prompt comum?
Um prompt comum pode gerar orientações gerais de acessibilidade. Esta skill é mais orientada à decisão: segue um fluxo de auditoria apenas com código, usa o enquadramento WCAG 2.2 mais WCAG2Mobile e prioriza patches mínimos em SwiftUI com status sustentados por evidências. Isso a torna mais adequada para trabalho de UX Audit em que rastreabilidade e escopo da mudança importam.
Ela é indicada para iniciantes?
Sim, desde que você consiga apontá-la para uma tela ou feature. Você não precisa conhecer todos os critérios WCAG, mas precisa fornecer contexto suficiente para a skill localizar o fluxo correto. Quanto mais concreto for o input, menor a chance de ela generalizar demais.
Quando não devo usar?
Não use se você quer testes no simulador em tempo real, QA visual ou uma revisão ampla de acessibilidade mobile que não seja centrada em SwiftUI. Ela também não é ideal quando você quer só uma opinião heurística rápida, sem rastreabilidade WCAG; nesse caso, uma skill de revisão SwiftUI mais leve é uma opção melhor.
Como melhorar a skill swiftui-wcag-accessibility-auditor
Delimite um recorte de feature menor
Os melhores inputs para swiftui-wcag-accessibility-auditor usage nomeiam um fluxo, um ou dois arquivos e um resultado de tarefa. Por exemplo, “Revise a tela de redefinição de senha e seus estados de erro” é melhor do que “audite o app”. Um escopo mais estreito ajuda a skill a separar bloqueios reais de observações de pouco valor.
Traga logo de cara os casos mais difíceis
Se a tela usa botões só com ícone, gestos personalizados, overlays, sheets, banners de validação, layouts sensíveis a Dynamic Type ou formulários controlados pelo teclado, diga isso. São justamente essas áreas que fazem swiftui-wcag-accessibility-auditor for UX Audit gerar os achados mais úteis e em que a falta de contexto mais derruba a qualidade.
Peça evidências e correções no nível de edição
Solicite achados com evidência de código, mapeamento WCAG e trechos mínimos de remediação. Isso empurra a skill para uma saída pronta para patch, em vez de conselhos abstratos. Se precisar de uma segunda passada, peça que ela se concentre nos itens ainda marcados como Needs user verification ou nos problemas P0 e P1 de maior prioridade primeiro.
Itere da auditoria para o patch
Depois da primeira passada, devolva os achados aceitos e peça uma refinamento de segunda passada no código restante. Essa é a forma mais rápida de melhorar a qualidade do resultado: a skill consegue ajustar a remediação, remover falsos positivos e transformar áreas incertas em checagens manuais específicas, em vez de recomendações amplas.