Ir para o conteúdo
Promovaweb

Impeccable

A Impeccable revisa interfaces existentes e orienta ajustes de design com comandos como critique, polish e harden. Confira a instalação e o uso.

Capa da skill Impeccable
Versão
4.8.0
Último commit
Licença
Apache-2.0
Mantenedor
Paul Bakaus
Estrelas
104.889

A Impeccable revisa o componente que você indicar com critique. O relatório aponta problemas de uso nessa interface. O comando polish aplica ajustes de acabamento. Com document, a skill registra o sistema visual existente em DESIGN.md, consultado nas alterações seguintes.

Como usar a skill Impeccable

O que preparar

Disponibilize o código da interface, a rota que será revisada e uma forma de abrir seus estados principais. A Impeccable usa PRODUCT.md para entender o objetivo da aplicação e DESIGN.md para conhecer o sistema visual. Informe esses arquivos quando já existirem.

Passo a passo

  1. Apresente o objetivo da interface.

    Use impeccable init para registrar o objetivo da aplicação e o público que a utiliza. Esse fluxo produz o PRODUCT.md. Em um ajuste pequeno de uma interface existente, a skill pode trabalhar com as convenções já presentes no código.

    Resultado esperado: uma descrição do objetivo da aplicação que orienta as próximas revisões.

  2. Peça uma crítica de uma parte identificável.

    Use critique para examinar a experiência de uso. O exemplo abaixo trata de um formulário existente. No Claude Code, substitua $impeccable por /impeccable.

    $impeccable critique /cadastro. Revise o formulário de cadastro de usuário, incluindo senha inválida, envio em andamento e erro do servidor. Preserve a identidade visual. Explique os problemas que dificultam concluir o cadastro e indique o que deve ser corrigido primeiro.

    Resultado esperado: uma análise da interface indicada, com problemas de hierarquia, compreensão e uso relacionados ao cadastro.

  3. Escolha o tipo de ajuste.

    Depois da análise, use polish para acabamento, harden para estados de erro e situações incomuns ou adapt para adequação a diferentes telas. Nomeie o componente e os problemas que deseja corrigir. Para verificar acessibilidade, desempenho e comportamento responsivo, use audit.

    Resultado esperado: um trabalho com objetivo definido, como tornar o erro do servidor compreensível ou corrigir o formulário no celular.

  4. Confira os estados e registre o sistema visual.

    Abra a interface alterada, teste o envio e percorra os controles com o teclado. Se precisar documentar as convenções visuais já implementadas, use document, que gera o DESIGN.md a partir do código existente.

    Resultado esperado: a interface revisada e as verificações realizadas. A documentação visual é uma entrega do comando document, não uma consequência automática de qualquer ajuste.

Instalar e atualizar

Instalar

Projeto atual

Execute na pasta do projeto para instalar a skill nesse projeto. O instalador permite escolher os agentes que receberão a instalação.

npx skills add pbakaus/impeccable --skill impeccable

Todos os projetos

Instale no seu usuário para usar a skill em diferentes projetos. O instalador permite escolher os agentes que receberão a instalação.

npx skills add pbakaus/impeccable --skill impeccable -g

Atualizar

Verificar atualizações

Consulte se há atualizações disponíveis para as skills instaladas antes de atualizar.

npx skills check

Atualizar skills instaladas

Atualize as skills instaladas para as versões disponíveis nos repositórios de origem.

npx skills update

Agentes compatíveis

Use esta skill no agente de sua preferência. Todos os agentes abaixo são compatíveis.

  • Claude CodeCompatível

    Use a distribuição do agente. A cópia manual não instala hooks nem subagentes.

  • CodexCompatível

    Use a distribuição do agente. A cópia manual não instala hooks nem subagentes.

  • AntigravityCompatível

    Use a distribuição do agente. A cópia manual não instala hooks nem subagentes.

  • Hermes AgentCompatível

    Use a distribuição do agente. A cópia manual não instala hooks nem subagentes.

  • OpenCodeCompatível

    Use a distribuição do agente. A cópia manual não instala hooks nem subagentes.

  • CursorCompatível

    Use a distribuição do agente. A cópia manual não instala hooks nem subagentes.

Versões e changelog

Versões publicadas como GitHub Releases do repositório. Consulta em 7 de novembro de 2026.

  1. 4.8.0

    Atual
    Ver no GitHub

    - **Devin and Replit Agent.** `npx impeccable install` sets the skill up for Devin on the web, in the CLI and on Desktop, and accepts `windsurf` as another name for it. A project with a `.replit` file is read as Replit Agent, so the installer names it, not Codex CLI, when it writes to `.agents`. Thanks to @faocampo and @Kodylow for asking.

  2. 4.7.0

    Ver no GitHub

    - **Critique and audit desktop apps.** Start an Electron, NW.js, CEF or WebView2 app with a debugging port and `impeccable detect --cdp 9222` scans the window you have open, as it stands, and leaves it exactly as it found it. Critique and audit know the recipe.

  3. 4.6.0

    Ver no GitHub

    - **Oh My Pi.** `npx impeccable install` sets the skill up for Oh My Pi next to the other harnesses.

  4. 4.5.2

    Ver no GitHub

    - **App screens and docs build code-first.** In blind ratings, generated images of working screens and documents scored well below code builds of the same brief, and often looked unfinished. Those surfaces now skip the image comp. Landing pages and showcases keep the build path you chose, and the toggle on the decision page still flips a single round.

  5. 4.5.1

    Ver no GitHub

    - **Findings you can trust on real pages.** Framed demos and mockups, elements caught mid-animation, consent banners and vendor badges on scanned URLs, and near-black text on a colour no longer raise findings. Line length counts the characters that actually render.

5 versões anteriores
  1. 4.5.0

    Ver no GitHub

    - **Working screens look finished.** Dashboards, boards and tools commit to a real palette, keep the controls your users already know, and are held to the cleanest product in their category. The chosen world adds one signature detail on top, such as service health drawn as a transit map.

  2. 4.4.0

    Ver no GitHub

    - **Review the component kit in your browser.** Each illustration, photo and rendered component sits next to its crop of the comp. Approve it, or say what needs fixing and the agent repairs it for the next round. Repeated pieces, like a row of cards, are reviewed together. Approvals carry over between rounds, and a component whose files change is reviewed again.

  3. 4.3.1

    Ver no GitHub

    - **Useful errors instead of silent exits.** Blocked cache writes and failed engine downloads now identify the required engine version, cache location, and recovery steps. Automatic first-use downloads and reuse of the cached engine are preserved.

  4. 4.3.0

    Ver no GitHub

    - **Artwork that belongs on your page.** Impeccable can now generate illustrations and objects with genuinely transparent backgrounds, ready to sit over your own colors and textures. Photos and full-frame artwork keep their backgrounds.

  5. 4.2.3

    Ver no GitHub

    - **Design hooks respect each app.** In monorepos, post-edit, before-edit, and Stop checks use the target app's DESIGN.md, with repository fallback and no sibling leakage. Thanks to @tylerjryan for the report and proposed approach.