For the complete documentation index, see llms.txt. This page is also available as Markdown.

Guia de Engenharia de Prompt para Skip

  • Agent (Automático): O Skip decide o melhor caminho para o seu pedido.

  • Build: Use quando tiver certeza de que quer mudar o código ou criar uma nova tela.

  • Chat: Ideal para tirar dúvidas ou planejar ideias gastando apenas 1 crédito de construção (dependendo do seu plano).

  • Upload: Use especificamente para enviar arquivos (PDF, Planilhas) que devem servir de base para o projeto.

No Skip, escrever um bom prompt não exige "engenharia complexa" nem frameworks misteriosos. Exige ser direto e específico. Quanto mais clareza você der ao agente, melhor será o resultado — e menos créditos você vai gastar refazendo.

A Regra de OuroTudo o que você não especifica, você está terceirizando a decisão para o agente. Se você não disser como quer, o Skip decide por você — e pode decidir diferente do que você imaginava.Por isso, um bom prompt sempre traz três pilares: Objetivo, Especificações e Restrições.

Os Três Pilares na Prática

Vamos usar um exemplo simples e didático: imagine que você quer construir um sistema para uma escola.

1. Objetivo

A meta principal — o que o sistema é na sua essência.

💬 "Crie um sistema de gerenciamento para escolas."

Esse é o núcleo. Sem ele, o agente não tem direção.

2. Especificações

Os detalhes do que o sistema precisa ter ou como ele deve se parecer. Funcionalidades, telas, integrações, referências visuais.

💬 "Tenha funcionalidade de cadastrar alunos e professores, e inspire-se no design do [referência]."

Quanto mais específico você for aqui, menos o agente vai precisar "chutar".

3. Restrições

As fronteiras — o que o sistema deve ou não fazer. É aqui que você evita surpresas.

💬 "Deve ter três tipos de acesso: professores, alunos e admin. Não deve ter nenhum outro tipo de acesso."

As restrições protegem o projeto de decisões automáticas que podem fugir do escopo.

Tamanho Ideal do Primeiro Prompt

No primeiro prompt, foque apenas no básico. Não tente descrever o sistema inteiro de uma vez — isso aumenta a chance de erro e o consumo desnecessário de créditos.

  • Comece pela funcionalidade principal.

  • Deixe o Skip entregar uma base sólida.

  • Evolua o projeto em prompts seguintes, uma camada por vez.

Momento Certo para o Banco de Dados

Esta é uma recomendação oficial para qualquer projeto que vai precisar guardar dados (cadastros, usuários, transações, conteúdo, etc.):

Ative o Skip Cloud antes de enviar o primeiro prompt.

Para isso, clique no ícone "+" na área do projeto e selecione Skip Cloud: Banco de Dados, Autenticação e Segredos.

Se esquecer, conecte no máximo até o terceiro, quarto ou quinto prompt. Evite deixar para depois da maior parte do app construída — adicionar banco mais tarde costuma exigir retrabalho significativo na estrutura de dados.

Construção Incremental

O Skip rende muito melhor quando você constrói em camadas:

  1. Estrutura visual: Defina as telas principais e os campos básicos.

  2. Lógica e navegação: Adicione a lógica de negócio e as conexões entre as telas.

  3. Banco de dados e permissões: Implemente o banco e defina os níveis de acesso de cada tipo de usuário.

Essa ordem preserva coerência e permite que você valide cada etapa antes de avançar.

Corrigindo e Refinando

Se o resultado não for o que você esperava, não refaça tudo do zero. Siga este fluxo:

  • Use o Bug Scanner (ícone de lupa na barra da pré-visualização) para identificar falhas específicas.

  • Entre no Modo Chat para planejar a correção antes de executar — o Chat custa 3 créditos e não altera código, ideal para refinar.

  • Seja cirúrgico nos pedidos de correção: "corrija apenas o erro X na página Y, sem alterar o restante".

Essa abordagem cirúrgica evita que a IA introduza novos bugs em partes do app que já estavam prontas.

Exemplo completo de um bom prompt

💬 "Crie um sistema de gerenciamento para escolas. Tenha funcionalidade de cadastrar alunos e professores, com campos de nome, e-mail, turma e data de nascimento. Inspire-se em interfaces minimalistas como o Linear. Deve ter três tipos de acesso: professores (veem suas próprias turmas), alunos (veem apenas suas notas) e admin (acesso total). Não deve ter nenhum outro tipo de acesso."

Veja como o prompt contém Objetivo + Especificações + Restrições em um único parágrafo enxuto.

Atualizado

Isto foi útil?