Communitygithub.com

Argus

Skill de design para construir, reformular, polir ou revisar páginas web e telas de aplicativos móveis em qualquer framework — incluindo landing pages, dashboards, componentes, formulários e sistemas de design.

O que é Argus?

O Argus é uma skill de design voltada para agentes de IA que precisam criar ou modificar interfaces visuais — páginas web, telas de app, componentes, formulários ou sistemas de design — em qualquer framework. Ele é útil para situações como "construa uma página para X", "adicione uma tela de configurações", "deixe isso com melhor aparência" ou "parece genérico", e também para adicionar nova UI a um projeto que já possui um estilo definido. O skill opera em múltiplas plataformas (web, iOS, Android) e se baseia em um conjunto de regras de design, como sempre verificar o resultado renderizado, não assumir a primeira ideia como a melhor e julgar por meio de comparações visuais. Ele segue um fluxo estruturado: primeiro, examina o que já existe (plataforma, superfície, sistema existente e referências fornecidas); depois, seleciona a rota de trabalho adequada (ajuste, comando nomeado, revisão, novo trabalho, etc.); para trabalho novo, faz uma rodada de perguntas para esclarecer o briefing; e, por fim, executa um loop de construção, visualização, verificação (com scripts e listas de erros comuns), uso e correção, em até duas rodadas. O Argus garante acessibilidade mínima (contraste 4.5:1, foco visível, alvos de toque de 44pt/48dp, suporte a movimento reduzido) e exige que conteúdo inventado (como Lorem Ipsum ou depoimentos falsos) seja marcado em comentários de código. A skill é suportada em ferramentas como Claude Code e Cursor, e depende de uma estrutura de referências (ask.md, create.md, extend.md, slips.md, verify.md, etc.) para guiar cada decisão.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hamza-Masuadi/argus-skill/tree/HEAD/skills/argus

Perguntar na sua IA favorita

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

Documentação

O que Argus faz?

Você conhece as regras de design. Quatro outras coisas dão errado, e esta skill responde a cada uma:

  1. Você não pode ver o que faz. Portanto, construa, olhe o resultado renderizado, corrija e olhe novamente.
  2. Sua primeira ideia é a primeira ideia de todos. Portanto, receba informações externas: o que existe, o que o usuário diz, o que ele mostra.
  3. Você julga melhor do que gera. Portanto, para trabalhos novos, faça alternativas brutas e escolha olhando.
  4. Você deriva para o médio e para o fino. Portanto, páginas novas recebem uma ideia, um grande movimento e um argumento completo.

1. Olhe o que existe

Antes de qualquer coisa, encontre e declare em uma linha:

  • Plataforma: web, ou um aplicativo móvel (iOS, Android, ambos). Leia o projeto; nunca presuma.
  • Superfície: Persuadir (marketing, landing, vitrine), Operar (dashboard, ferramenta, admin, tela de app) ou Ler (docs, artigos).
  • Sistema existente: DESIGN.md, arquivos de tema ou tokens, componentes compartilhados, duas ou três telas finalizadas.
  • O que o usuário forneceu: capturas de tela, links, logotipos, cores da marca, fontes, fotografias.

Implemente com o framework e as convenções que o projeto já utiliza.

2. Siga a única rota que se encaixa

Use a primeira linha da tabela que corresponder. Leia apenas os arquivos que ela nomeia.

A tarefaFaçaLeia
Um ajuste: um componente, uma correção de espaçamento ou corFaça a alteração e olhe. Sem perguntas, relatório de uma linhaNada, ou a parte de craft.md que ele toca
Um comando nomeado (polish, audit, typeset, colorize, animate, simplify, variants)Siga o comandoreferences/commands/<nome>.md e o que ele nomear
"Reveja isto" ou "critique isto"Relate, não altere nadareview.md, laws.md, verify.md
"Deixe isso com melhor aparência", "parece genérico", em algo que existeDescubra o que está realmente errado e corrija dentro da aparência existenteextend.md seção 3, depois commands/polish.md; para uma fraqueza clara, o comando correspondente
Nova tela ou componente em um projeto que tem uma aparênciaEstenda. Sem trabalho de direção, sem perguntasextend.md; mais product.md para superfícies Operar, mobile.md para nativo
Nova superfície Operar sem nada para corresponderPergunte se o briefing está aberto, depois construaask.md, product.md, craft.md; mobile.md se for nativo
Nova superfície Persuadir ou Ler sem nada para corresponderPergunte se o briefing está aberto, depois o fluxo completoask.md, create.md (que traz structures.md e ingredients.md), web.md ou mobile.md; photos.md se as imagens vendem ou se fotos foram fornecidas
Um redesenho que o usuário pediu explicitamenteTrate como trabalho novo, mantendo conteúdo e comportamentoA linha de trabalho novo correspondente, mais extend.md seção 1 para inventariar o que deve sobreviver

Toda rota que constrói algo termina no loop abaixo, com slips.md e verify.md. Ajustes precisam apenas de uma olhada.

Alterar a identidade de um produto existente precisa de um pedido explícito. Sem um, "fazer brilhar" significa melhor trabalho dentro da aparência atual.

3. Pergunte (apenas trabalho novo)

Quando o briefing deixar em aberto para quem é, como deve soar ou o que o usuário tem a mostrar, pergunte antes de projetar: uma rodada, no máximo quatro perguntas sobre o produto, cada uma opcional, nenhuma sobre fontes ou cores. Para uma página nova, pergunte também em torno do que a primeira tela deve ser construída (três abordagens que você propõe para este assunto) e quantas direções eles querem ver lado a lado (1, 3 ou 5; 3 é recomendado). ask.md as contém. Pule perguntas que o briefing ou DESIGN.md já respondem.

Se ninguém estiver lá para responder, declare cada suposição e siga em frente. Nunca espere em um loop.

4. O loop

  1. Construa a primeira versão real.
  2. Olhe. Renderize e capture em 320, 390 e 1440 de largura (para nativo, em um simulador ou dispositivo do tamanho de um telefone). Antes de ler o código novamente, anote o que está visível.
  3. Verifique contra slips.md. Execute os scripts que se aplicam (veja verify.md).
  4. Use. Pressione o botão principal, preencha o formulário, navegue por Tab, encontre a navegação na largura de telefone.
  5. Corrija o que encontrou e olhe novamente. Duas rodadas, depois relate o que restou.

Se nada puder ser renderizado, diga isso, verifique a fonte e não chame o trabalho de verificado. Para trabalho substancial (uma página ou tela inteira) quando houver subagentes, entregue as capturas de tela a um revisor novo que não tenha visto seu raciocínio; suas correções contam como uma das duas rodadas.

Regras que sempre valem

  • De quem é a palavra final: uma instrução explícita do usuário; depois o sistema existente; depois as respostas e referências do usuário; depois a direção que você escreveu; depois os números e listas desta skill. Mínimos de acessibilidade não são sobrepostos por gosto, seu ou desta skill. Algo que o usuário pediu nunca é relatado como defeito.
  • Conteúdo honesto. Sem lorem ipsum e sem provas inventadas: depoimentos, clientes, logotipos, avaliações, números de uso. Fatos que uma página precisa (um preço, termos de teste) podem ser substitutos plausíveis, marcados em um comentário de código e listados no relatório. Dados de amostra em uma demonstração, catálogo ou dashboard são bem-vindos quando específicos e são rotulados como amostra uma vez na tela.
  • Reformulação nunca muda comportamento. Mantenha nomes de campos, IDs, links, manipuladores, ações de formulário, hooks de teste e atributos de acessibilidade.
  • Construa os estados que podem acontecer, e todos eles. Pressionado e desabilitado sempre; hover e foco de teclado onde houver um ponteiro ou um teclado. Carregando, vazio e erro onde algo real carrega, pode estar vazio ou pode falhar. Nunca construa uma chamada de rede apenas para ter um estado de carregamento.
  • Mínimos de acessibilidade: contraste de texto 4,5:1; foco de teclado visível; controles com pelo menos 24px e 44pt / 48dp em telas sensíveis ao toque; um caminho de movimento reduzido; nada perdido quando o texto é ampliado. craft.md tem os números e laws.md o padrão exato.
  • Verificado significa olhado.

Relatório

Encontrado:  plataforma, superfície, sistema existente, o que o usuário forneceu
Direção:     uma frase (trabalho novo), ou o que foi reutilizado e o que foi adicionado (extensão)
Olhado:      o que foi renderizado, em quais larguras, o que foi usado manualmente
Corrigido:   o que o loop capturou
Suposto:     fatos substitutos e dados de amostra, por tipo, ou "nenhum"
Aberto:      o que não está feito ou não foi verificado, e qualquer coisa que um guia mande sinalizar

Mantenha-se nestas linhas. Um ajuste recebe uma linha.

Arquivos

ArquivoContém
ask.mdA rodada de perguntas
create.mdTrabalho novo de Persuadir e Ler: a ideia, o grande movimento, alternativas brutas, a direção
structures.mdEstruturas de página para escolher, para que as alternativas difiram na forma e não apenas na cor
ingredients.mdOs papéis de token que toda direção preenche, e as opções de cor, tipo, forma e espaço
extend.mdTrabalhar dentro de uma aparência existente
product.mdSuperfícies Operar: dashboards, ferramentas, telas de app
photos.mdPáginas lideradas por fotografias
web.md, mobile.mdO que vai onde em uma página web ou tela de telefone
slips.mdErros realmente cometidos, por superfície. Verificado a cada olhada
verify.mdComo capturar, verificar e revisar; os scripts auxiliares
craft.mdTodos os números: tipo, cor, espaço, movimento, alvos
laws.mdO que as leis de UX justificam e não justificam; mitos
tells.mdPadrões comuns de design gerado
review.md, design-md.mdFormato de crítica; registro de decisões

Todos estão em references/.

Todo caminho nesta skill (references/..., scripts/..., assets/...) é relativo à pasta que contém este arquivo, não ao projeto do usuário. No Claude Code, essa pasta é ${CLAUDE_SKILL_DIR}. Ao executar um script, use seu caminho completo, por exemplo node "<pasta desta skill>/scripts/lint.js" <alvo>.

Habilidades Relacionadas