Text to CAD

ANÁLISE EDITORIAL

Text to CAD é uma Agent Skill para transformar requisitos em modelos CAD paramétricos e, principalmente, obrigar o agente a validar o que gerou. O fluxo parte de uma descrição, imagem de referência ou desenho técnico, cria uma fonte em Python e trata STEP como o artefato principal. STL, 3MF e GLB entram como exportações secundárias, não como substitutos da geometria editável.

A versão auditada está no repositório earthtojake/text-to-cad, commit 9068fdb. Em 13 de agosto de 2026, a API pública do GitHub registrava 13.359 estrelas. O projeto declara a versão 0.4.7 e usa licença MIT, que permite redistribuição com preservação do aviso de copyright e da permissão.

Imagem editorial exclusiva do Bastidores da IA. Não é captura de tela, interface real, desenho de fabricação nem prova de validação de engenharia.

O que esta Skill faz de verdade

O SKILL.md auditado define um processo em dez etapas. Primeiro, o agente classifica a tarefa, por exemplo, peça nova, conjunto, modificação de fonte, inspeção de STEP ou exportação. Depois, transforma os requisitos em um briefing de CAD com dimensões, unidade, origem, eixos, hipóteses, caminhos de saída e verificações esperadas.

Para modelagem nova, a orientação padrão é escrever uma fonte Python baseada em build123d e gerar o STEP a partir dessa fonte. Para um arquivo STEP já existente, a Skill permite inspeção direta quando não há gerador. O ponto importante é que a fonte continua sendo a parte editável do trabalho. Alterar apenas um STL ou outro arquivo derivado quebra a rastreabilidade que a Skill tenta preservar.

A validação também é explícita. O agente deve conferir referências geométricas, contagens, limites, posicionamento, medidas e alinhamentos relevantes. Há um comando separado para verificar a sanidade da geometria, porque conseguir selecionar faces não prova que o sólido está fechado ou orientado corretamente. Depois de criar ou alterar uma peça visível, a Skill exige uma captura de revisão e uma segunda leitura visual.

Para quem serve

Ela pode ajudar makers, projetistas, equipes de robótica, desenvolvedores de ferramentas de fabricação e pessoas que já trabalham com CAD paramétrico em código. É especialmente útil quando uma peça precisa ser reproduzível: um suporte, caixa, gabarito, espaçador, conjunto mecânico ou adaptação que deve continuar editável depois do primeiro resultado.

Não é uma ferramenta de certificação. A própria instrução exclui conclusões de FEA, engenharia certificada, CAM e BIM quando o pedido não inclui geometria CAD. Também não decide tolerâncias, material, folga funcional ou processo de fabricação sem dados. Se uma medida for crítica para encaixe, segurança ou conformidade, o agente precisa parar e pedir a informação que falta.

A finalidade não se repete com as Skills já publicadas no Bastidores. Expo Upgrade organiza migrações de aplicativos móveis. Supabase Postgres Best Practices trata banco de dados. NVIDIA Skill Card Generator cria documentação de Skills. Text to CAD é a primeira entrada do catálogo dedicada a geometria paramétrica, STEP e inspeção dimensional.

Compatibilidade e pré-requisitos

O README oficial oferece instalação pelo Skills CLI e plugins para Codex e Claude Code. O plugin do Codex exige a versão 0.142.0 ou mais recente. Em outros agentes, o requisito básico é reconhecer pastas com SKILL.md e permitir que o agente execute os comandos necessários no projeto.

A pasta skills/cad fixa cadgen==0.4.7 e Playwright. A versão completa inclui Python, módulos JavaScript, ferramentas para gerar, inspecionar, exportar e produzir snapshots, além de um daemon local usado pelo fluxo de geração. Portanto, não basta copiar apenas o Markdown se você espera gerar um STEP. É preciso instalar o runtime oficial e ter Python, Node quando solicitado pelo fluxo e espaço para os artefatos CAD.

O projeto afirma que o processamento principal roda localmente. Ainda assim, a instalação baixa pacotes, e a Skill pode abrir um navegador local para revisão visual. O ambiente do agente deve limitar a execução ao projeto correto e não deve receber acesso amplo a outras pastas apenas por conveniência.

Instalação recomendada

O método preferido pelo mantenedor usa o Skills CLI:

npx skills install earthtojake/text-to-cad

Esse comando instala a biblioteca de Skills do repositório, não somente a pasta CAD. Revise a lista apresentada, confirme o destino e comece em um projeto descartável. Para usar o plugin do Codex, o README atual orienta:

codex plugin marketplace add earthtojake/text-to-cad
codex plugin add cad@text-to-cad

Depois da instalação, confirme que a origem é o repositório oficial, registre o commit aprovado e confira a versão do cadgen. Reinicie o agente se a Skill não aparecer. O site oficial do projeto resume as Skills disponíveis e mantém os comandos atuais de instalação.

O ZIP hospedado pelo Bastidores tem outra função. Ele preserva o SKILL.md, nove referências Markdown, a licença e o registro de origem do commit auditado. Os 92 arquivos de runtime e configuração foram excluídos, incluindo scripts Python e JavaScript, dependências, daemon e ferramentas de execução. Assim, o pacote local é verificável e redistribuível, mas não é uma instalação funcional completa.

Configuração antes do primeiro uso

Prepare um pedido com unidades, dimensões principais, origem preferida, plano de base, direção de extrusão, material apenas quando ele afetar a geometria e formato de saída. Para conjuntos, identifique peças fixas, relações de montagem e superfícies ou eixos usados como referência. Se houver componente comprado, informe o modelo exato e não aceite um bloco genérico sem registrar a aproximação.

Defina também os arquivos que o agente pode criar. Uma convenção simples é manter nome.step.py, nome.step e snapshots em uma pasta específica do projeto. Ative controle de versão para a fonte, mas não trate tamanho de arquivo ou alteração binária do STEP como prova de correção. A Skill manda comparar fonte, medições, topologia e imagens de revisão.

Primeiro uso seguro

Comece com uma peça simples e sem risco, por exemplo:

Crie um suporte de teste em milímetros.
Base: 80 x 50 x 6 mm.
Dois furos passantes de 5,5 mm, centros a 12 mm das laterais.
Uma parede vertical de 50 x 40 x 6 mm no centro da base.
Saída principal: suporte-teste.step.
Entregue também a fonte Python, medidas verificadas e uma captura de revisão.
Não escolha tolerâncias ou material por conta própria.

O resultado esperado inclui a fonte paramétrica, o STEP, um relatório de inspeção com dimensões e relações pedidas e uma imagem de revisão. Se você solicitar STL ou 3MF, eles devem sair do mesmo fluxo e continuar identificados como derivados. Abra a captura, confira furos, espessuras, orientação e proporção. Depois, faça uma segunda medição no CAD de sua escolha antes de fabricar.

Permissões e riscos

A versão completa executa código Python e Node, cria processos locais, lê modelos existentes e grava arquivos no projeto. O daemon pode criar um socket local. As ferramentas removem arquivos temporários e alguns artefatos obsoletos gerados pelo próprio fluxo. Por isso, use uma cópia ou repositório com histórico e revise o caminho de destino antes de autorizar qualquer comando.

O risco mais importante não é apenas segurança de software. Um modelo pode parecer correto e ainda ter unidade errada, sólido aberto, interferência, folga inadequada ou detalhe impossível de fabricar. Snapshot ajuda a encontrar defeitos visuais, mas não substitui medição, protótipo, revisão de montagem ou validação profissional quando houver consequência física.

A licença MIT preservada no pacote permite o download local auditado. Ela também informa que o software é fornecido sem garantia. O Bastidores não é mantenedor do projeto e não oferece validação de engenharia para os arquivos produzidos.

Erros comuns

A Skill aparece, mas os comandos falham

Confirme Python, o ambiente virtual, cadgen==0.4.7 e Playwright. Se a mensagem citar Node ou npm, instale o requisito indicado pelo mantenedor no projeto de teste. Não tente resolver copiando executáveis de origem desconhecida.

O STEP foi criado, mas a inspeção reprova o sólido

Volte à fonte Python e corrija a menor etapa responsável. Regere o alvo explícito, repita a validação de geometria, as medidas afetadas e o snapshot. Não edite o STEP ou STL manualmente para esconder o problema.

A captura não abre

Verifique Playwright, navegador disponível, aceleração gráfica e caminho do arquivo. A referência snapshot-review.md explica os únicos casos em que a captura pode ser dispensada. Falha de ferramenta não transforma a validação visual em opcional.

O agente inventou dimensões

Reescreva o briefing e separe dimensões obrigatórias, valores apenas estéticos e perguntas bloqueantes. Defaults da Skill são hipóteses iniciais, não especificações de fabricação. Para encaixe, segurança ou norma, informe o valor ou peça uma pergunta antes da modelagem.

Versão auditada e download local

• Repositório: earthtojake/text-to-cad.
• Caminho: skills/cad.
• Versão: 0.4.7.
• Commit: 9068fdb4d08487590030beefde5630da09c0f97b.
• Estrelas: 13.359 em 13/08/2026, consultadas na API pública do GitHub.
• Licença: MIT.
• Conteúdo do ZIP: SKILL.md, nove referências Markdown, LICENSE e ORIGEM.md.
• SHA-256 do ZIP: dff8cd519726d31ab196588998b6a3d471906456815703f27025f8d6ea5598a2.

Use o download local para conferir exatamente o material revisado. Use o botão separado do repositório oficial para instalar o runtime completo, acompanhar mudanças e ler a documentação atual. O guia de Skills do Bastidores ajuda a entender a diferença entre instrução, plugin e permissão de execução.

Resultado esperado e limite final

Uma boa execução termina com fonte reproduzível, STEP identificável, verificações registradas, snapshot revisado e hipóteses visíveis. O agente deve conseguir explicar de onde vieram as dimensões e quais testes realmente rodaram.

O limite final é concreto: Text to CAD organiza geração e validação, mas não transforma linguagem natural em peça pronta para fabricar sem engenharia. Meça, prototipe e revise a montagem antes de usar qualquer resultado em equipamento, carga ou situação que possa causar dano.

Fontes primárias

• Pasta oficial da Skill CAD no commit auditado.
• SKILL.md oficial.
• README oficial com instalação e compatibilidade.
• Site oficial da biblioteca.
• Licença MIT preservada no pacote.