Felpborges

Skill Auditoria Deploy — DevOps skill for Claude Code

DevOps community

Skill para Claude Code que garante que projetos Node.js subam e funcionem na Hostinger (CommonJS + porta 3000).

How to install Skill Auditoria Deploy

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Felpborges/skill-auditoria-deploy and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Skill Auditoria Deploy does

Skill para Claude Code que garante que projetos Node.js subam e funcionem na Hostinger (CommonJS + porta 3000).

Alternatives in DevOps

  • Cloudflare Deploy — Deploy apps to Cloudflare using Workers, Pages, and platform services 14.6k ★
  • Vinext — Vite plugin that reimplements the Next.js API surface — deploy anywhere 8.7k ★
  • Claudable — Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code, Codex, Gemini CL 4k ★

README

Skill: auditoria-deploy

Uma skill para Claude Code que garante que seu projeto **suba e funcione** na Hostinger — em vez de dar erro depois do deploy.

Cobre os quatro caminhos, cada um com um fluxo diferente no painel:

Seu projeto é… Como publica Precisa mudar algo?
Site estático (HTML/CSS/JS) Adicionar site → Site PHP/HTML → Avançado → GIT Não
React / Vite / Vue Adicionar site → Implante web app Não
Next.js (com servidor) Adicionar site → Implante web app Não
Node + Express Adicionar site → Implante web app Sim — duas regras

Todos os quatro foram testados em produção, não deduzidos.

O problema que ela resolve

Se o seu projeto é um **servidor Express**, a Hostinger tem duas exigências:

  1. O código precisa ser CommonJS (require), não ESM (import)
  2. O app precisa cair na porta 3000

Quando qualquer uma é violada, acontece o pior tipo de erro possível:

  • o painel mostra "Implantação concluída"
  • o status fica "Em execução"
  • os logs ficam vazios, sem uma linha sequer
  • e o visitante vê 503 Service Unavailable

Nada aponta a causa. Você fica horas procurando um erro que não aparece em lugar nenhum.

**E o detalhe que pega todo mundo:** a IA escreve `import` por padrão, porque é o formato moderno do JavaScript. Não é erro dela — ela só não sabe onde o seu código vai rodar.

Num teste com o mesmo pedido ("cria uma landing… vou hospedar na Hostinger"), **sem a skill o projeto nasceu em ESM mesmo com a Hostinger citada no pedido.** Com a skill, nasceu pronto para publicar.

⚠️ **Essas duas regras valem SÓ para Express.** Em projeto React, Vite, Vue ou Next, remover `"type": "module"` **quebra o build**. A skill sabe diferenciar — e é metade do valor dela.

Instalação

Um comando:

git clone https://github.com/Felpborges/skill-auditoria-deploy.git ~/.claude/skills/auditoria-deploy

Pronto. Na próxima conversa com o Claude Code, a skill entr