teach-impeccable

Visão geral

O que é teach-impeccable?

teach-impeccable é uma skill de configuração única criada para ajudar você a coletar, definir e manter o contexto de design do seu projeto. Ao executar essa skill, você estabelece diretrizes claras e consistentes de design de UI que são salvas no arquivo de configuração da sua IA, garantindo que sua equipe e ferramentas consultem os mesmos padrões visuais em todas as sessões futuras.

Quem deve usar teach-impeccable?

Essa skill é ideal para designers de UI, desenvolvedores front-end e equipes de produto que desejam documentar e manter uma direção de design consistente. É especialmente útil para projetos que precisam alinhar branding, identidade visual e experiência do usuário desde o início.

Quais problemas ela resolve?

• Evita desvios no design ao capturar ativos da marca, tokens de design e preferências estéticas desde o começo.
• Reduz o tempo de integração de novos membros da equipe ao fornecer uma referência de design persistente.
• Auxilia ferramentas de IA e automação a gerar UI que corresponda ao estilo e requisitos únicos do seu projeto.

Como usar

Passos para instalação

1. Adicione a skill ao seu projeto:
   Execute o seguinte comando no diretório do seu projeto:

   npx skills add https://github.com/pbakaus/impeccable --skill teach-impeccable
   

2. Revise a documentação:
   Comece pelo arquivo SKILL.md para um fluxo de trabalho guiado. Para um contexto mais aprofundado, consulte README.md, AGENTS.md e metadata.json, se disponíveis.
3. Explore seu código:
   • Analise seu README, documentação e arquivos de configuração para entender o propósito do projeto, stack tecnológico e ativos de design existentes.
   • Identifique padrões de design atuais, tokens e diretrizes da marca.
4. Esclareça com perguntas focadas em UX:
   • Pergunte aos stakeholders sobre os usuários, personalidade da marca e preferências visuais que não estejam evidentes no código.
5. Persista suas descobertas:
   A skill ajudará a salvar esse contexto de design no arquivo de configuração da sua IA, tornando-o acessível para sessões futuras e ferramentas automatizadas.

Quando teach-impeccable é indicado?

• Ao iniciar um novo projeto e querer estabelecer uma base sólida de design.
• Ao integrar novos designers ou desenvolvedores que precisam de diretrizes visuais claras.
• Ao usar ferramentas de IA ou automação que se beneficiam de um contexto de design explícito.

Quando pode não ser adequado?

• Para projetos sem interface ou componente visual.
• Se suas diretrizes de design já estiverem bem documentadas e integradas em outro lugar.

Perguntas frequentes

O que exatamente o teach-impeccable faz?

Ele orienta você a coletar todo o contexto relevante de design — como ativos da marca, tokens de design e objetivos dos usuários — e salva essas informações no arquivo de configuração da sua IA para referência persistente.

Preciso executar o teach-impeccable mais de uma vez?

Não, é pensado para uma configuração única. Você pode executá-lo novamente se a direção do design mudar significativamente.

Onde encontro arquivos e scripts de suporte?

Confira primeiro o arquivo SKILL.md. Para mais contexto, explore o README.md, AGENTS.md e pastas de suporte como rules/, resources/ ou references/ no repositório.

Como isso ajuda minha equipe?

Ao tornar o contexto de design explícito e persistente, teach-impeccable garante que todos — humanos e IA — trabalhem com o mesmo manual visual, reduzindo falhas de comunicação e retrabalho.

teach-impeccable é específico para algum framework ou stack?

Não, é independente de framework e foca no contexto de design, não nos detalhes de implementação.