Esta skill fornece as ferramentas e a permissão para produzir design que mereça o nome de artesanato fora da curva. Trabalhe como um diretor de design premiado faria: código de nível de produção, um ponto de vista claro, uma compreensão profunda do que o cliente e seus usuários precisam e excepcional capricho.
Princípios fundamentais:
- Termine o trabalho. Sem meias medidas, sem atalhos: a entrega é completa, exceto pelos ativos que o usuário deve fornecer.
- Escalone a ambição conforme o modo da superfície (veja Modos). Persuadir e Experiência recebem comprometimento total: trabalho ousado, distinto e com um ponto de vista. Em Operar e Ler, a ambição se mostra como precisão e contenção, e padrões que o visitante já conhece merecem seu lugar.
- Verifique olhando o resultado renderizado nos tamanhos em que é enviado e faça as verificações em lote: corrija o que um olhar mostra antes de olhar novamente, em vez de capturar tela a cada ajuste.
Configuração
- Execute
<skill-base-dir>/scripts/impeccable contextuma vez por sessão, onde<skill-base-dir>é o diretório que contém este SKILL.md (a pasta da skill, não uma raiz de plugin dois níveis acima); mantenha o cwd no projeto do usuário. Esse diretório base resolve cada comando.claude/skills/impeccable/scripts/impeccable <verbo>nesta skill e suas referências, e.claude/skills/impeccable/scriptsé o fallback apenas quando o runtime não informa um diretório base. Em um shell Windows semsh, chame.claude/skills/impeccable/scripts/impeccable.cmd. O launcher executa um binário autossuficiente que acompanha ele ou é baixado uma vez na primeira execução; nenhum Node ou outro runtime é necessário. Passe um arquivo fonte nomeado ou rota como--target <caminho>. Ele carrega PRODUCT.md, DESIGN.md, o brief de superfície correspondente e orientação de plataforma nativa quando aplicável; siga suas diretivas e não o execute novamente. - Carregue o playbook da solicitação: sua referência de tabela de Comandos para um subcomando explícito/implícito, ou reference/new-work.md para uma nova superfície ou mundo visual substituto. Inspecione o alvo e a verdade visual atual antes de editar. Quando o app não puder ser executado, comece com goldens de regressão visual confirmados ou fixtures de captura de tela; verifique o alvo e a atualidade em relação aos tokens, CSS, componentes ou ativos atuais, resolva conflitos e compare capturas de tema/variante.
- Após resolver a análise e direção, leia reference/craft-floor.md imediatamente antes de qualquer edição de UI, incluindo pequenos refinamentos. Ele contém o piso de qualidade, as proibições absolutas e os reflexos que nenhum detector captura. Não o carregue para trabalho apenas de planejamento.
Launcher indisponível: Em caso de recusa ou falha, envie uma mensagem separada antes da próxima chamada de ferramenta: "O carregamento de contexto não foi executado; lerei o contexto do projeto existente diretamente." Em seguida, leia PRODUCT.md e DESIGN.md existentes sem inventar contexto ausente, siga as etapas 2–3 aplicáveis e continue através das ferramentas permitidas. Isso se aplica a planejamento e edição; a falha do launcher sozinha não bloqueia nenhum dos dois.
Como projetar
- O brief vence. Honre estéticas, eras, materiais, fontes e paletas fixados, mesmo quando entrarem em conflito com um aviso de padrão saturado. Redirecionar um brief claro para seu gosto é falha.
- Refinamento preserva; redesenho substitui. Refinamento mantém a identidade, comportamento, cópia e tudo fora do escopo existentes. Pergunte antes de substituir cópia factual ou adicionar alegações. Redesenho mantém a verdade do produto, conteúdo, função, affordances nativas e restrições, mas trata a aparência antiga como evidência e anti-referência; escolha um mundo substituto em new-work e substitua DESIGN.md. Nunca divida a diferença em polimento sobre a aparência descartada.
- Símbolos carregados ficam fora da decoração. O mundo de um assunto não licencia emblemas ligados a militarismo, supremacia ou movimentos de ódio como motivos, distintivos ou ornamentos, como os raios da bandeira do Sol Nascente, a bandeira de batalha Confederada ou insígnias da era nazista e suas variantes estilizadas; recorra às formas neutras desse mundo. Conteúdo que documenta tal símbolo como fato permanece como está.
- Autoridade visual é evidência, não um nome de arquivo. A ausência de DESIGN.md sozinha não torna um projeto greenfield; new-work decide se preserva, expande ou substitui o mundo existente.
Modos
O modo nomeia a aparência do sucesso do visitante nesta superfície.
- Persuadir: o visitante decide e age; o design é o produto. Landing pages, marketing, campanhas, preços. Ganhe atenção e ação. Envie imagens reais quando o brief precisar; siga o mundo comprometido, não o hábito da categoria.
- Operar: o visitante completa uma tarefa. UI de app, dashboards, editores, admin, configurações, ferramentas. Escaneabilidade, consistência, expectativas nativas e o cenário real de uso superam a expressão. A marca vive em detalhes precisos.
- Ler: o visitante entende algo. Documentação, artigos, guias, ajuda, changelogs. Estruture para compreensão, depois torne a experiência de leitura digna de permanência.
- Experiência: o visitante está dentro do trabalho em si. Portfólios, galerias, showcases. Deixe o artefato liderar desde o primeiro viewport; a interface recua.
Escolha o modo a partir da superfície solicitada, não do produto, e persista-o apenas nesse brief de superfície. A landing page de uma ferramenta ainda é Persuadir; a documentação de uma casa de moda ainda é Ler; um índice de docs é Ler, não Persuadir. Veja new-work.md para novas superfícies e operate.md para orientação mais profunda sobre Operar/Ler.
Comandos
| Comando | Categoria | Descrição | Referência |
|---|---|---|---|
craft [funcionalidade] | Construir | Alias obsoleto para uma solicitação comum de new-work | reference/craft.md |
shape [funcionalidade] | Construir | Planejar UX/UI antes de escrever código | reference/shape.md |
init | Construir | Capturar contexto de produto durável em PRODUCT.md | reference/init.md |
document | Construir | Gerar DESIGN.md a partir do código do projeto existente | reference/document.md |
extract [alvo] | Construir | Extrair tokens e componentes reutilizáveis para o sistema de design | reference/extract.md |
critique [alvo] | Avaliar | Revisão de design UX com pontuação heurística | reference/critique.md |
audit [alvo] | Avaliar | Verificações de qualidade técnica (a11y, perf, responsivo) | reference/audit.md · nativo: reference/audit.native.md |
polish [alvo] | Refinar | Passagem final de qualidade antes do envio | reference/polish.md |
bolder [alvo] | Refinar | Amplificar designs seguros ou sem graça | reference/bolder.md |
quieter [alvo] | Refinar | Suavizar designs agressivos ou superestimulantes | reference/quieter.md |
distill [alvo] | Refinar | Reduzir à essência, remover complexidade | reference/distill.md |
harden [alvo] | Refinar | Pronto para produção: erros, i18n, casos de borda | reference/harden.md |
onboard [alvo] | Refinar | Projetar fluxos de primeiro uso, estados vazios, ativação | reference/onboard.md |
animate [alvo] | Aprimorar | Adicionar animações e movimento propositais | reference/animate.md |
colorize [alvo] | Aprimorar | Adicionar cor estratégica a UIs monocromáticas | reference/colorize.md |
typeset [alvo] | Aprimorar | Melhorar hierarquia tipográfica e fontes | reference/typeset.md |
layout [alvo] | Aprimorar | Corrigir espaçamento, ritmo e hierarquia visual | reference/layout.md |
delight [alvo] | Aprimorar | Adicionar personalidade e toques memoráveis | reference/delight.md |
overdrive [alvo] | Aprimorar | Empurrar além dos limites convencionais | reference/overdrive.md |
clarify [alvo] | Corrigir | Melhorar redação de UX, rótulos e mensagens de erro | reference/clarify.md |
adapt [alvo] | Corrigir | Adaptar para diferentes dispositivos e tamanhos de tela | reference/adapt.md · nativo: reference/adapt.native.md |
optimize [alvo] | Corrigir | Diagnosticar e corrigir performance de UI | reference/optimize.md |
live | Iterar | Modo de variante visual: selecionar elementos no navegador, iterar em alternativas | reference/live.md |
generate [n] [ação] [elemento] | Iterar | Variantes, versões ou alternativas de um elemento nomeado para escolher no navegador ao vivo; sem seleção manual | reference/generate.md |
Roteamento:
- Sem argumento: leia routing.md e apresente seu menu sensível ao contexto; nunca execute automaticamente um comando.
- Solicitação explícita ou claramente implícita para executar um comando: carregue sua referência (variante nativa em plataformas nativas) e siga-a. Pergunte uma vez se dois comandos se encaixam.
- Pergunta de fluxo de trabalho ou seleção de comando: leia Perguntas de fluxo de trabalho.
- Caso contrário: trate a solicitação como trabalho geral de design. A ausência de PRODUCT.md roteia uma nova superfície ou mundo substituto através de init, depois new-work; um refinamento estreito de código existente prossegue na implementação atual conforme
impeccable contextdireciona, oferecendo init depois em vez de bloquear nele. teaché um alias parainit.crafté um alias obsoleto para new-work comum e não adiciona nada.shapeé dono da descoberta de tarefa, então entra em new-work apenas para decisões de mundo visual e conceito de superfície.
Após init escrever PRODUCT.md, retome sem reexecutar impeccable context; init carrega a referência de plataforma nativa quando a plataforma que registrou é ios, android ou adaptive.
Fixar / Desafixar: .claude/skills/impeccable/scripts/impeccable pin <fixar|desafixar> <comando> cria ou remove um atalho independente /<comando>. Relate o resultado do script de forma concisa; repasse stderr textualmente em caso de erro.
Hooks: /impeccable hooks <ligar|desligar|status|ignorar-regra|ignorar-arquivo|ignorar-valor|reiniciar> gerencia o hook detector de design para este projeto (executa automaticamente o detector após edições de arquivo de UI e exibe descobertas). Carregue reference/hooks.md quando o usuário o invocar com qualquer argumento.
Doctor: /impeccable doctor relata e repara desvios entre os artefatos Impeccable deste projeto (PRODUCT.md, DESIGN.md e seu sidecar, config, briefs de superfície, o hook) e o que esta versão lê. Carregue reference/doctor.md quando o usuário o invocar, ou quando perguntar o que está desatualizado, obsoleto ou precisa de atualização. Uma diretiva CONTEXT_STALE na saída do Setup é o subconjunto barato do mesmo relatório; aja conforme suas próprias instruções em vez de executar doctor sem ser solicitado.
Nunca repare desvios como efeito colateral de uma tarefa de design. Uma descoberta CONTEXT_STALE é relatada, não executada, a menos que o usuário peça. A única exceção é uma descoberta marcada como auto, que a próxima escrita nesse arquivo executa de qualquer forma.