O que ux-skill faz?
Mecanismo de inteligência de design para ferramentas de codificação de IA (Claude Code, Cursor, Windsurf). Linter determinístico anti-sujeira de IA com 152 regras, 160 especificações de marca, um sintetizador de 7 eixos, um servidor MCP (18 ferramentas), 25 comandos, 17 IDEs. Offline, nunca chama um LLM. MIT.
Visão Geral
O Laith0003/ux-skill é uma ferramenta essencial para desenvolvedores que utilizam agentes de IA em seus fluxos de trabalho de codificação. Ele atua como um fiscal de qualidade de design, garantindo que o código gerado por IA não contenha inconsistências visuais, más práticas de UX ou elementos que pareçam 'sujeira de IA'. Sua operação é totalmente offline e determinística, o que significa que as regras são aplicadas de forma consistente e previsível, sem depender de conexão com a internet ou de modelos de linguagem.
Funcionalidades Principais
- Linter Anti-AI-slop: 152 regras pré-definidas para detectar e corrigir padrões de design ruins comuns em código gerado por IA.
- Especificações de Marca: 160 conjuntos de especificações de marca prontos para uso, abrangendo guias de estilo, paletas de cores, tipografia e espaçamento.
- Sintetizador de 7 Eixos: Avalia e melhora o design com base em 7 eixos fundamentais: usabilidade, acessibilidade, estética, performance, consistência, responsividade e semântica.
- Servidor MCP: 18 ferramentas remotas via Model Context Protocol para integrar o skill a IDEs e editores de código.
- Comandos Diretos: 25 comandos de terminal para execução de tarefas específicas, como análise de projeto, geração de componentes e aplicação de regras.
- Suporte a IDEs: Compatível com 17 IDEs populares, incluindo VS Code, JetBrains, Sublime Text e mais.
Como Funciona
- O skill é invocado por comandos no terminal ou via ferramentas MCP no ambiente de desenvolvimento.
- Ele analisa o código projetado pelo agente de IA (HTML, CSS, JS, etc.) em busca de violações das regras de design.
- Aplica correções automaticamente ou sugere alterações, dependendo da configuração.
- O sintetizador de 7 eixos fornece uma pontuação geral de qualidade de design e recomendações de melhoria.
- As especificações de marca podem ser aplicadas para garantir consistência com a identidade visual do projeto.
Exemplo de Uso
# Analisar um projeto
ux-skill analyze ./meu-projeto
# Aplicar regras automaticamente
ux-skill lint --fix ./meu-projeto
# Gerar relatório detalhado
ux-skill report ./meu-projeto --format json
Licença
Este projeto é distribuído sob a licença MIT. Consulte o arquivo LICENSE para obter mais detalhes.
Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues e pull requests no repositório oficial Laith0003/ux-skill.