Communitygithub.com

markitui-build-pages

Skill de design. Construa páginas de sites ou lojas online na sua própria cópia do arquivo Figma MarkitUI a partir de blocos da biblioteca: um plano de página para aprovação, blocos de projeto, e então frames de página xl e base (mais frames md opcionais para tablet) com notas de handoff para desenvolvedores.

O que é markitui-build-pages?

Este skill automatiza a criação de páginas web no Figma usando o sistema de design MarkitUI. Ele transforma briefings, sitemaps, listas de páginas, sites de referência ou sites existentes em páginas completas dentro da cópia do usuário do arquivo Figma MarkitUI. O fluxo de trabalho é estruturado em quatro fases: planejamento da página (com aprovação do usuário), criação de blocos de projeto, composição das páginas para diferentes breakpoints (xl, base e opcionalmente md para tablet) e adição de notas de handoff para desenvolvedores. O skill lê a documentação do arquivo Figma como fonte da verdade e pergunta questões preliminares para entender a origem das páginas, variantes responsivas, nome do projeto e tipo de site. Ele funciona exclusivamente com o servidor MCP do Figma e requer acesso de escrita. As principais vantagens são a automação do processo de design, a consistência com o sistema de design MarkitUI e a geração de páginas responsivas prontas para desenvolvimento.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/studio-coal/markitui/tree/HEAD/skills/markitui-build-pages

Perguntar na sua IA favorita

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

Documentação

MarkitUI: construir páginas

Transforme um briefing, um sitemap, uma lista de páginas, um site de referência ou um site existente em páginas finalizadas no arquivo Figma MarkitUI do usuário. O fluxo é sempre:

bloco da biblioteca → bloco de projeto → página composta em um componente Breakpoint → frames {Page} / xl e {Page} / base desanexados (e {Page} / md se o usuário quiser tablet) em uma Seção por página → notas de handoff.

A própria documentação do arquivo é a fonte da verdade. No início de cada execução, leia os frames de documentação Compondo páginas, Layout e Breakpoints na página de Documentação, e o frame de documentação Navegação para a lista de categorias de blocos. Quando o site tiver um blog, changelog, histórias de clientes ou eventos, leia também o frame de documentação Páginas de arquivo na página Componentes de arquivo e o frame de documentação Montando páginas de arquivo e detalhe na página Blog (Arquivo / Post). Se algo neste skill discordar deles, siga o arquivo.

Antes de começar

  • Trabalhe apenas na própria cópia do MarkitUI do usuário. Peça o link do Figma se você não o tiver.
  • Escrever no Figma precisa do servidor MCP do Figma com acesso de escrita. Carregue as orientações do MCP do Figma para escrever em arquivos (seu skill figma-use) antes da primeira edição, e crie uma sessão primeiro se o servidor solicitar.
  • Mude de páginas do Figma no máximo uma vez por script. Encontre páginas, componentes e coleções de variáveis pelo nome, não pelo ID.
  • Blocos da biblioteca e componentes base são finais. Nunca os edite para fazer uma página funcionar. Se algo não puder ser feito com um bloco como ele é, informe o usuário e pergunte.

Perguntas iniciais

Antes de qualquer planejamento, pergunte o que o prompt do usuário já não esclarece, em uma mensagem (use perguntas de múltipla escolha onde a interface as oferecer). Pule uma pergunta apenas quando o prompt a responder de forma inequívoca.

  1. A partir do que as páginas devem ser construídas?

    • um briefing ou descrição do negócio
    • um sitemap ou lista de páginas
    • um site de referência a seguir (estrutura apenas, novo texto)
    • o site existente deles para reconstruir (mantém o texto deles)
    • qualquer outra coisa que eles tenham: capturas de tela, um documento, sites concorrentes, um wireframe
  2. Variantes responsivas: quantas variantes de breakpoint cada bloco e página devem ter?

    • xl + base (desktop e mobile; padrão, blocos da biblioteca estão prontos)
    • xl + md + base (adiciona tablet: uma variante md em cada bloco de projeto e um frame md para cada página)
    • md apenas para algumas páginas (eles nomeiam as páginas)

    Dê a troca de uma linha de references/responsive.md. Nunca adicione md sem um sim.

  3. Nome do projeto, usado em cada nome de componente (ex.: Acme).

  4. Tipo de site: site de marketing, loja online, ou ambos.

  5. Onde construir: uma nova página Figma no arquivo (ex.: ↳ Páginas Acme) a menos que o usuário nomeie uma.

  6. Texto: o texto real do usuário, texto escrito no estilo de um site de referência, ou texto placeholder crível.

  7. Para lojas: país, moeda e formato de número, taxa de IVA ou imposto sobre vendas.

Em seguida, colete o que a fonte escolhida precisa: o briefing, o sitemap, ou a URL do site (e para um site de referência ou existente, leia references/existing-site.md).

Use blocos de projeto por padrão. Use blocos da biblioteca diretamente apenas se o usuário pedir um protótipo rápido ou uma única landing page.

Fluxo de trabalho

Fase 1: Plano de página (pare para aprovação). Leia references/page-planning.md. O plano declara os breakpoints que o usuário escolheu. Faça um inventário da biblioteca, escolha blocos para cada página e apresente a tabela do plano. Para páginas de Blog, Changelog, Histórias de Clientes ou Eventos & Webinars, leia references/content-types.md e planeje uma página de arquivo e um template de detalhe para cada uma. Quando a entrada for um site existente para reconstruir, leia references/existing-site.md primeiro; ele produz o mesmo plano. Pare e aguarde aprovação ou alterações.

Fase 2: Blocos de projeto. Leia references/project-blocks.md. Clone cada bloco da biblioteca escolhido em um bloco de projeto, renomeie-o e adapte-o no mestre. Construa a navbar, menus e footer também como blocos de projeto. Para blocos de arquivo, defina os componentes de arquivo (cabeçalho, barra lateral, paginação) no mestre do bloco de projeto como references/content-types.md descreve. Se o usuário escolheu md, leia references/responsive.md e adicione uma variante md a cada bloco de projeto que as páginas md usam.

Fase 3: Compor as páginas. Leia references/composing.md e references/content.md. Construa cada página em xl em um componente Breakpoint, duplique para base (e md, seguindo references/responsive.md), desanexe, nomeie, envolva em uma Seção e organize a tela.

Fase 4: Notas de handoff. Leia references/handoff.md. Adicione a anotação de rota a cada frame xl e anotações de comportamento e conteúdo onde um frame estático não pode mostrar o que acontece.

Verifique e relate. Leia references/checks.md. Execute as verificações do script, capture a tela de cada página em cada breakpoint que ela tem, corrija o que encontrar e então relate.

Arquivos de referência: leia cada um quando sua fase chegar

  • references/page-planning.md: anatomia da página, escolha de blocos, a tabela do plano. Fase 1.
  • references/existing-site.md: reconstruindo um site existente. Fase 1, quando a entrada é um site ao vivo.
  • references/content-types.md: páginas de arquivo e detalhe para Blog, Changelog, Histórias de Clientes e Eventos & Webinars; ArchiveHeader, ArchiveSidebar e ArchivePagination. Fases 1–3, quando o site tem algum deles.
  • references/project-blocks.md: clonagem, nomeação, o que mudar no mestre, regras de design. Fase 2.
  • references/responsive.md: a opção md, adicionando variantes md a blocos de projeto, montando páginas md com o componente Breakpoint. Perguntas iniciais, Fase 2 e Fase 3, quando md é escolhido.
  • references/composing.md: componente Breakpoint, xl e base, desanexação, nomeação, layout da tela. Fase 3.
  • references/content.md: texto, dados de loja, datas, imagens. Fase 3.
  • references/handoff.md: formatos de anotação que desenvolvedores e o skill generate-code dependem. Fase 4.
  • references/checks.md: auditoria, capturas de tela e o relatório. Último.

Inegociáveis

  • Faça as perguntas iniciais que o prompt não responder, incluindo variantes responsivas, antes do planejamento.
  • Pare após o plano e aguarde aprovação. Nunca construa páginas a partir de um plano não aprovado.
  • Nunca edite blocos da biblioteca, componentes base ou componentes de arquivo; todas as alterações vão para blocos de projeto ou substituições de instância.
  • Cada página tem um frame xl e um frame base (e um frame md se escolhido) construídos a partir dos mesmos blocos, e o Breakpoint de cada bloco corresponde ao seu frame.
  • Tudo permanece nas variáveis e estilos de texto do MarkitUI. Sem cores, espaçamentos, raios ou configurações de fonte brutos.
  • Texto real ou crível, nunca Lorem ipsum. Sem marcas ou logotipos reais que não sejam do usuário.
  • Cada frame xl recebe uma anotação de rota no formato exato em references/handoff.md.

Habilidades Relacionadas