O Velk foi feito para ser usado conversando com uma IA. Essa IA é o Claude Code, o assistente da Anthropic que trabalha nos arquivos de um projeto: ele lê, escreve e roda comandos no seu computador, e você aprova o que ele faz.
Sozinho, o Claude não conhece o Velk. A skill do Velk é o pacote de conhecimento que ensina: como o site.json funciona, quais campos existem e o passo a passo para instalar, publicar, atualizar e fazer backup de um site. Você instala uma vez e ela serve todos os projetos Velk daquele computador.
Tenha o Claude Code
O Claude Code existe em algumas formas, e todas fazem o mesmo trabalho. Se você não vive no terminal, use o aplicativo de desktop: baixe em claude.ai/download, instale como qualquer programa e entre com a sua conta do Claude. O Claude Code é a aba Code do aplicativo: você escolhe a pasta do projeto e conversa.
A versão de terminal e as extensões para VS Code e JetBrains rodam o mesmo assistente, e tudo destas páginas vale para elas. Escolha uma e fique com ela enquanto aprende; trocar depois não custa nada.
Peça à IA
Instale a skill do Velk de skill.velkcms.com
Digite no Claude Code, em qualquer pasta. A IA instala a skill uma vez só, como plugin do Claude, e ela vale para todos os projetos.
/plugin install velk --marketplace elleven-digital/velk-skill numa conversa do Claude Code, ou adicione o marketplace elleven-digital/velk-skill no app, em Personalização → Plugins.O que tem dentro
A skill não é um programa com botões. É um conjunto de instruções que a IA lê antes de agir:
- Uma orientação sobre como o Velk funciona: a estrutura no
site.json, o tema em PHP puro, o motor que ninguém edita. - Um guia por tarefa: construir, vários idiomas, instalar, atualizar o motor, publicar, arquivos de acesso para clientes, editar conteúdo no ar, converter HTML em tema e backup.
- Scripts testados para tudo que conversa com um servidor por SSH (a conexão criptografada com a sua hospedagem). Publicar, copiar um site do ar ou fazer backup roda sempre do mesmo jeito, em vez de ser improvisado.
Não tem sub-comandos
Não existe velk deploy ou velk install para decorar. Você escreve em português o que quer, e a skill escolhe o fluxo. Variações também funcionam: ela lê a intenção, não uma sintaxe. Ela entra sozinha quando o pedido fala do Velk ou quando a pasta é um projeto Velk; numa pasta vazia, diga o nome (“Instale o Velk aqui”).
Frases que funcionam
| Você quer | Pode dizer |
|---|---|
| Instalar o Velk numa pasta vazia | “Instale o Velk aqui” |
| Pôr um site no ar pela primeira vez | “Sobe esse site na Hostinger” |
| Publicar mudanças do tema | “Publica as mudanças do tema” |
| Trazer o site do ar para o seu computador | “Baixa o site de produção pro meu local” |
| Atualizar o motor | “Atualiza o Velk pra última versão” |
| Mudar conteúdo do site no ar | “Cria um post sobre o nosso novo horário no site no ar” |
| Fazer backup | “Faz um backup do site de produção” |
| Transformar um site em HTML em tema | “Converte esse HTML num tema Velk” |
| Dar acesso a um cliente | “Crie um arquivo de acesso desse site” |
Skill ou `bin/velk`?
| A skill do Velk | O comando `bin/velk` |
|---|---|
| Conhecimento que a IA lê: como o Velk funciona e o fluxo de cada tarefa. | Uma ferramenta que vem com o motor, dentro de cada projeto, com comandos de verdade como schema:validate, migrate e serve. |
| Instalada uma vez no Claude, como plugin: uma cópia para todos os projetos. | Mora na pasta bin/ do projeto e é atualizada junto com o motor. |
| Você conversa com ela em português. | A IA roda por você e mostra o resultado; você nunca precisa digitar. |
Peça à IA
Atualiza a skill do Velk e me diz qual versão ficou instalada.
Faça de vez em quando, e antes de um trabalho grande, como o primeiro deploy ou uma atualização do motor: o que cada versão nova do Velk exige está escrito na skill.
Preciso saber programar?
Não. Você descreve o que quer, e a IA escreve a estrutura, os templates e os comandos. O que você precisa é o hábito de ler o que ela propõe; veja Conversando com a IA.
Custa alguma coisa?
A skill é gratuita e de código aberto (licença MIT). O Claude Code é usado com uma conta do Claude; veja no claude.ai quais planos incluem o Claude Code.
Posso usar outra IA?
A skill é feita para o Claude Code. Todo projeto Velk também traz o AGENTS.md, a referência do motor para agentes de IA, que outros assistentes conseguem ler; os fluxos destas páginas vêm da skill.
Um guia antigo instala a skill em ~/.claude/skills/velk. Ainda funciona?
Funciona: é o pacote, a mesma skill, mas sem atualização pelo Claude. Prefira o plugin e, depois de instalá-lo, apague a pasta ~/.claude/skills/velk para valer só a cópia do plugin.