netlify-config

Visão geral da skill netlify-config

Para que serve a netlify-config

A skill netlify-config é uma referência prática para escrever e ajustar netlify.toml. Use a skill netlify-config quando você precisar configurar builds, redirects, rewrites, headers, deploy contexts, variáveis de ambiente, functions ou edge functions sem ficar chutando a sintaxe da Netlify.

Quem deve usar

Ela é mais indicada para quem já sabe o que quer que a Netlify faça, mas precisa de uma forma confiável de expressar isso corretamente. O guia netlify-config é especialmente útil para mudanças de deploy que são fáceis de errar de forma sutil, como a ordem dos redirects, roteamento catch-all ou configurações específicas por contexto.

O que a torna útil

Esta skill foca nos detalhes de configuração que afetam o comportamento real do deploy: localização do arquivo, estrutura TOML, correspondência de regras e opções específicas da Netlify, como condições e regras forçadas. Se você está decidindo entre um prompt genérico e a skill netlify-config, a skill é a melhor escolha quando precisão importa mais do que brainstorming.

Como usar a skill netlify-config

Instale e carregue a skill

Use o fluxo de instalação da netlify-config no seu processo de skills e depois abra skills/netlify-config/SKILL.md como ponto de partida. O repositório apresenta a skill atualmente como uma referência de arquivo único, então não há scripts auxiliares nem recursos complementares para sair procurando.

Transforme seu objetivo em um prompt utilizável

O melhor uso da netlify-config começa com um objetivo de deploy concreto, não com um pedido vago. Um bom input nomeia o tipo de site, o arquivo que você está editando e o resultado que você precisa. Por exemplo: “Atualize netlify.toml para que /docs/* reescreva para /docs/index.html em produção, mas mantenha /api/* fazendo proxy para o backend em todos os deploy contexts.”

Leia primeiro as partes certas

Comece pelos exemplos de build settings e redirects, depois examine as seções que correspondem à sua mudança: headers, deploy contexts, functions ou edge functions. Na prática, a forma mais rápida de usar netlify-config para Deployment é mapear o comportamento de roteamento desejado ao exemplo mais próximo e então adaptar a sintaxe, em vez de inventá-la do zero.

Dicas que melhoram a qualidade da saída

Informe à skill o caminho atual do arquivo, o diretório de saída do framework e quaisquer regras conflitantes que já existam. Diga se você precisa de uma rewrite, um redirect ou um proxy, porque essas escolhas alteram o valor correto de status e se force é necessário. Se você estiver trabalhando em um monorepo, declare explicitamente o base directory para que a configuração vá para o lugar certo.

Perguntas frequentes sobre a skill netlify-config

A netlify-config serve só para netlify.toml?

Sim, a skill netlify-config é centrada em netlify.toml e no comportamento de deploy que ele controla. Se o seu problema for uma estratégia mais ampla de hospedagem na Netlify, a skill ainda ajuda quando a tarefa principal é sintaxe de configuração ou desenho de regras.

Quando um prompt normal já basta?

Um prompt comum é suficiente para ideias gerais, como “como funcionam redirects na Netlify?”. A skill netlify-config é melhor quando você precisa de uma resposta pronta para deploy, especialmente para precedência de rotas, rewrites ou configurações específicas por contexto em que pequenos erros de sintaxe quebram builds.

Ela é amigável para iniciantes?

Sim, desde que você consiga descrever seu objetivo de deploy em linguagem simples. O principal obstáculo não é a dificuldade da skill; é a falta de informações completas. Iniciantes conseguem resultados melhores quando informam o comando de build atual, a pasta de publicação e os padrões de caminho que querem alterar.

Quando eu não devo usar?

Não use a netlify-config se você ainda estiver escolhendo entre plataformas ou se não souber se a mudança pertence a redirects, headers ou build settings. Ela é uma skill de configuração, não um explicador geral da Netlify nem uma consultora de arquitetura de site.

Como melhorar a skill netlify-config

Informe o problema exato de roteamento

As melhores saídas da skill netlify-config vêm de exemplos de caminho bem precisos. Em vez de “corrija os redirects”, forneça o caminho antigo, o caminho de destino, o código de status desejado e quaisquer exceções. Isso permite que a skill escolha entre 301, 302, 200 e 404 sem ambiguidade.

Inclua o contexto de deploy e as restrições

Para netlify-config for Deployment, o contexto faz diferença: comportamento só em produção, diferenças entre preview deploys e variáveis específicas de ambiente mudam a resposta certa. Diga se a regra deve valer globalmente ou apenas sob um deploy context, e mencione quaisquer restrições existentes de CMS, SPA ou API.

Peça o arquivo final, não só orientação

Uma solicitação útil para o guia netlify-config deve pedir o trecho exato de netlify.toml que você possa colar, além de uma nota curta explicando onde ele deve entrar no arquivo. Isso reduz idas e vindas e facilita identificar erros de ordenação antes do deploy.

Itere a partir do primeiro teste de deploy

Depois que a primeira configuração estiver pronta, teste o comportamento real do caminho e refine com base no que a Netlify de fato entrega. Falhas comuns incluem regra sobrescrita, ausência de force = true e confusão entre redirects e rewrites; o próximo prompt deve descrever o comportamento observado, não apenas o comportamento pretendido.