Nota do autor: o VibeHub Skill transforma linguagem coloquial em requisitos que o Agent consegue executar diretamente, adicionando no máximo 3 termos relevantes por vez. Este artigo explica como instalá-lo, como usar as duas funcionalidades, onde os Tokens realmente são gastos e como conectar as requisições do modelo à APIYI.
Já adianto a conclusão: O VibeHub é responsável por deixar sua linguagem coloquial mais precisa; os Tokens são gastos no modelo chamado pelo Agent, não nas consultas do próprio VibeHub.
Quando se usa um Agent para Vibe Coding, há duas situações comuns. A primeira é quando você diz “quero que este botão mude de cor ao passar o mouse e também dê algum feedback ao clicar”, e o Agent entende errado, entregando algo que não corresponde. A segunda é quando a resposta do Agent traz termos como Tooltip, Hover e atualização otimista, que você não entende e não sabe como responder na mensagem seguinte. O VibeHub Skill lida justamente com esses dois problemas e tem um limite claro: adiciona no máximo 3 termos realmente relevantes por vez.
Ele não vai te dar um curso de front-end. O README do repositório deixa claro que ele não oferece roteiro de estudos, plano de curso ou exercícios locais, e também não transforma uma necessidade simples em um tutorial.
Ao ler este artigo, você vai encontrar: uma frase de instalação que pode enviar diretamente ao Agent; o uso e os limites de cada uma das duas funcionalidades; a diferença entre “este Skill não exige uma chave API” e “o Agent onde ele está instalado continua consumindo Tokens do modelo”; e, ao conectar os Tokens do Agent à APIYI, qual endereço usar para OpenAI compatível e qual usar para Anthropic nativo.
O que é o VibeHub: um guia de termos de Vibe Coding para agentes entenderem linguagem coloquial
O site do VibeHub é vibe-hub.org. A página inicial em chinês se posiciona como “guia visual de termos de Vibe Coding: use linguagem simples para encontrar os termos certos de front-end, back-end e IA”. A barra de navegação tem entradas para Termos, Prática, Cursos, Evitar o estilo de IA, Atualizações, Skill e Grupo de troca. O autor é Oil; o site pessoal e o perfil no GitHub estão nas referências ao final.
No próprio site, Vibe Coding também tem verbete: expressar a necessidade à IA em linguagem natural, deixar a IA escrever o código e iterar continuamente conforme os resultados de execução. Em chinês, isso também costuma ser chamado de “programação por atmosfera” ou “programação por intuição”. Há uma frase no verbete que vale a pena lembrar: funcionar não significa ser confiável; antes de ir ao ar, ainda é preciso revisar código, testes e permissões. Essa frase vale também para todos os fluxos de trabalho com agentes mencionados adiante.
| Ponto | Descrição | Valor para você |
|---|---|---|
| Site | vibe-hub.org, guia visual de termos (texto original da página de apresentação do Skill: 360 termos visualizados) | Ao encontrar um conceito desconhecido, dá para consultar uma explicação em linguagem simples |
| Repositório do Skill | GitHub oil-oil/vibe-hub-skill, licença MIT |
Faz o agente usar automaticamente as regras de terminologia durante a conversa |
| Recurso 1 | Expressão padronizada: reescreve a fala em um requisito que pode ser enviado diretamente | Reduz interpretações equivocadas pelo agente |
| Recurso 2 | Sugestões proativas: destaca no máximo 3 termos relevantes por vez | Ajuda a entender a resposta e saber o que dizer em seguida |
| Limite de custos | O próprio Skill não configura conta nem chave API | Os tokens são gastos apenas no modelo chamado pelo agente |
Divisão de responsabilidades entre o Skill VibeHub e o site VibeHub
A divisão entre os dois está bem clara no README do repositório: o conteúdo dos termos é mantido pelo vibe-hub.org; o repositório guarda apenas as regras de expressão e o parser de termos. Ou seja, o site cuida de “o que este termo significa e qual imagem o acompanha”, enquanto o Skill cuida de “quando mencionar esse termo, como reescrever sua fala e de onde vem o link”.
No diretório skills/vibehub/ do repositório há quatro arquivos: SKILL.md define as regras de expressão, agents/openai.yaml é a configuração para o host do agente, scripts/vibehub.mjs é o script de análise de termos e vibehub.config.json é a configuração do parser. O Skill inteiro não contém lógica de chamada de modelo, e isso determina a atribuição de tokens explicada mais adiante.
Como instalar o VibeHub Skill em um minuto
A instalação não exige criação de conta nem preenchimento de qualquer chave. Conforme os limites de configuração do README, basta atender a dois pré-requisitos: ter Node.js 20 ou superior na máquina e conexão à internet.
Duas formas de instalar o VibeHub Skill
- Modo 1: enviar uma frase diretamente ao Agent (texto original da página de apresentação do Skill):
https://github.com/oil-oil/vibe-hub-skill 帮我安装这个仓库里的 skills/vibehub Skill。 - Modo 2: instalar com o comando skills (texto original do README do repositório):
npx skills add oil-oil/vibe-hub-skill - Depois da instalação: o host do Agent recarrega o Skill e ele passa a funcionar em novas conversas.
O primeiro modo é indicado para quem não quer lidar com o terminal: basta colar a frase inteira na caixa de diálogo do Agent, e ele mesmo faz o download e a instalação. O segundo é para quem já tem familiaridade com a linha de comando; o resultado é o mesmo. Nenhum dos dois pede que você preencha uma chave API, porque este Skill executa apenas o script de resolução de termos que vem incluído.
| Item de configuração | Requisito do VibeHub Skill | Origem |
|---|---|---|
| Ambiente de execução | Node.js 20 ou superior | Texto original do README do repositório |
| Rede | Requer conexão à internet (consulta de termos em vibe-hub.org) | Texto original do README do repositório |
| Conta / chave API | Sem configuração de conta ou chave API | Texto original do README do repositório |
| Licença | MIT | Texto original do README do repositório |
| Formato do comando de resolução | node skills/vibehub/scripts/vibehub.mjs resolve, com um ou mais --query, opcionalmente com --compact |
Texto original do README do repositório |
Como as consultas de termos do VibeHub são enviadas
O resolvedor não envia o pedido inteiro diretamente para a interface de busca. O fluxo é: o Agent primeiro infere os termos candidatos conforme o contexto atual e depois faz uma consulta em lote para validar nomes e links. Quando a confiança é alta, consulta apenas um; quando há ambiguidade, compara no máximo três.
As regras de links são rigorosas: usa apenas a url retornada pelo resolvedor, sem concatenar por conta própria nem forjar; se não houver correspondência, informa diretamente, sem inventar termos ou links. Portanto, os links do VibeHub que você vê nas respostas são todos retornados de fato pela interface de consulta.
🚀 Dica para começar rápido: depois de instalar o VibeHub, a cada rodada de reescrita e explicação o Agent fará uma invocação do Modelo de Linguagem Grande. Se você quiser compartilhar uma única chave entre diferentes Agents e ver a fatura de forma unificada, pode primeiro registrar uma conta em APIYI apiyi.com e usar a pequena cota de teste fornecida após o registro para validar o fluxo de ponta a ponta.
As duas funcionalidades do VibeHub: deixar a linguagem coloquial mais precisa e complementar com no máximo 3 termos
A página de apresentação do Skill resume as capacidades em 2 funcionalidades principais. A seguir, uso o exemplo da própria página para cada uma, sem expandir além disso.
Funcionalidade 1: o VibeHub transforma a linguagem coloquial em um requisito que o Agent consegue executar diretamente
A frase original é: “Este botão muda de cor quando passo o mouse por cima; e quando clico, também precisa dar algum tipo de feedback.”
O resultado da reescrita é: “Adicione ao botão os estados Hover e Active, e use Transition para deixar a mudança de estado mais natural.” Na página, os três termos linkam, respectivamente, para os verbetes /hover, /active e /transition em vibe-hub.org.
O ponto-chave desta etapa é preservar a intenção original. O Skill não acrescenta frameworks, parâmetros ou soluções de implementação por conta própria; por exemplo, não decide por você o valor da cor, a duração da animação nem substitui uma biblioteca de UI. O que você recebe é um requisito que pode enviar diretamente ao Agent, com o mesmo sentido que você queria expressar; apenas as palavras foram trocadas por uma formulação que o Agent tem menos chance de interpretar mal.
Funcionalidade 2: o VibeHub aponta proativamente os termos que você precisa conhecer
A frase original é: “Quero que esta configuração passe a valer imediatamente quando eu a alterar; não quero precisar clicar em salvar de novo.”
O Skill vai sugerir Switch: ele é adequado a cenários com apenas dois estados, ligado e desligado, em que a alteração passa a valer na hora; se você precisa alterar vários itens e só depois confirmar tudo junto, não se deve projetar assim. Essa explicação está ligada diretamente à sua tarefa atual e diz quando usar e quando não usar, em vez de apresentar uma definição de enciclopédia.
A sugestão proativa segue três regras (texto original da página de apresentação do Skill):
- o termo, na primeira vez que aparece, é linkado ao VibeHub;
- a explicação acompanha a tarefa atual e não traz definição de enciclopédia;
- no máximo 3 termos realmente relevantes são sugeridos a cada vez.
| Critério de comparação | Funcionalidade 1: expressão padronizada | Funcionalidade 2: sugestão proativa |
|---|---|---|
| Quando entra em ação | Sua necessidade está expressa de forma vaga | Por trás da sua necessidade há um conceito de design que você não verbalizou |
| Conteúdo gerado | Um requisito reescrito pronto para enviar | 1 a 3 termos + uma explicação ligada à tarefa |
| Termos de exemplo | Hover, Active, Transition | Switch |
| O que não faz | Adicionar frameworks, parâmetros ou soluções de implementação por conta própria | Trazer definições de enciclopédia ou explicar o glossário termo por termo |
| Seu próximo passo | Depois de confirmar, enviar diretamente ao Agent | Avaliar se a solução é adequada e então decidir como falar |
Quando não entender a resposta do Agent, use o VibeHub para explicar apenas os conceitos-chave
Se, na resposta do Agent, aparecerem de repente termos como Tooltip ou atualização otimista, você pode colar o texto original. Segundo o README, ele explica apenas os conceitos que mais influenciam sua próxima decisão, sem traduzir o parágrafo inteiro palavra por palavra e sem começar uma aula automaticamente.
Os princípios de trabalho descritos no README podem ser resumidos em quatro pontos: entregar primeiro um resultado que possa ser usado diretamente e depois explicar o termo; preservar a intenção do usuário; no máximo 1 a 3 termos por vez; se a expressão já estiver precisa, não forçar uma explicação didática. O último ponto é bem prático: se você já explicou tudo com clareza, ele não vai falar mais do que o necessário.
Onde exatamente os tokens do VibeHub Skill são gastos
Este é o ponto mais fácil de confundir. O VibeHub Skill em si não recebe uma chave API, e a consulta de terminologia também não é uma invocação do Modelo de Linguagem Grande. O script de parsing apenas envia uma consulta em lote para vibe-hub.org e recebe de volta os nomes e links dos termos.
Quem realmente consome tokens é o Agent que tem esse Skill instalado. Reescrever a sua fala informal, explicar termos em linguagem simples e depois montar a página: essas três etapas são invocações do modelo. O Skill deixa a entrada e a saída dessas invocações mais precisas, mas não paga a conta por você, e as invocações em si não desaparecem.
| Etapa | Quem executa | Chama o Modelo de Linguagem Grande? | Consome tokens do modelo? |
|---|---|---|---|
| Inferir termos candidatos | Agent | Sim | Sim |
| Consultar termos e links em lote | Script de parsing do VibeHub → vibe-hub.org | Não | Não |
| Reescrever o pedido em linguagem coloquial | Agent | Sim | Sim |
| Explicar termos em linguagem simples | Agent | Sim | Sim |
| Escrever código e ajustar a página conforme o pedido | Agent | Sim | Sim |
Então, se você precisa recarregar créditos ou escolher um modelo, o alvo é o serviço de modelo por trás do Agent, e não abrir uma conta no site da VibeHub. O help-apiyi já tem um artigo, “De onde vem a conta de tokens de tarefas longas do Agent”, que detalha como o cache de prefixo em tarefas longas afeta a conta; não vou repetir isso aqui.
A conclusão correspondente ao gráfico acima é: as requisições de modelo do Agent podem apontar para APIYI (apiyi.com); uma única chave e o mesmo saldo cobrem tanto os modelos da família Claude quanto os da família GPT, sem nenhuma alteração do lado do VibeHub.
Use a APIYI para consultar modelos, comparar preços e direcionar as requisições do Agent
A APIYI é um gateway de API, não um provedor de hospedagem de modelos. Com uma única chave e o mesmo saldo, você pode chamar modelos de vários fornecedores. O registro da conta é manual; após o cadastro, há uma pequena cota de teste, e a plataforma não oferece roteamento gratuito de modelos. A lista completa de modelos e preços está na tabela geral de modelos docs.apiyi.com/models, com dados vindos da interface de preços em tempo real do sistema.
Escolha o endpoint conforme o SDK, não conforme o modelo
Ao direcionar as requisições do Agent para a APIYI, primeiro veja qual SDK o seu Agent usa e preencha o endereço correspondente:
- Compatível com OpenAI: preencha
base_urlcomhttps://api.apiyi.com/v1. Chat Completions usa/v1/chat/completions; Responses usa/v1/responses. - Anthropic nativo: preencha
base_urlcom o domínio raizhttps://api.apiyi.come não adicione/v1novamente; caso contrário, será montado/v1/v1/messagese retornará 404. O endpoint Messages é/v1/messages. - Escolha do endpoint:
api.apiyi.comé o endpoint padrão;b.apiyi.comé usado para backup e cenários corporativos;api-cf.apiyi.comsó oferece suporte a texto, com limite de timeout de aproximadamente 100 segundos, e não é adequado para tarefas longas.
A documentação também recomenda que modelos OpenAI GPT-5 e posteriores priorizem o Responses. Se você usa vários Agents ao mesmo tempo, como Claude Code e Codex, o tutorial do help-apiyi 《Tutorial passo a passo: uma única chave conecta todos os Agents e usa o magpie open-source para acessar uniformemente o gateway de API》 explica a abordagem de acesso unificado.
Preços dos modelos mais usados no Vibe Coding (texto original da tabela geral)
Os dados da tabela abaixo foram atualizados em 13/11/2026 12:57 (UTC+8), em dólares por 1 milhão de tokens, conforme o texto original da tabela geral de modelos do APIYI apiyi.com. A recarga segue a taxa de câmbio fixa de 1:7; o preço efetivo com desconto de cada grupo deve ser conferido no console após o login, e a coluna “a partir de” desta leva de modelos está como “—”.
| ID do modelo | Entrada | Saída | Leitura de cache | Endpoint | Grupos |
|---|---|---|---|---|---|
claude-opus-5-5 |
$4 | $20 | $0.2 | chat, messages | ClaudeCode, Claude_Reverse, Claude_Enterprise, Default, SVIP |
claude-sonnet-5-5 |
$2 | $10 | $0.1 | chat, messages | ClaudeCode, Claude_Reverse, Claude_Enterprise, Default, SVIP |
claude-fable-5-2 |
$8 | $40 | $0.2 | chat, messages | ClaudeCode, Claude_Enterprise, Default, SVIP |
gpt-6.1-sol † |
$2 | $10 | $0.1 | responses (recomendado), chat | CodexResponses, Codex_Reverse, Default, SVIP |
gpt-6.1-terra |
$1 | $5 | $0.05 | responses (recomendado), chat | CodexResponses, Codex_Reverse, Default, SVIP |
Alguns complementos, separados por ID:
claude-opus-5-5,claude-sonnet-5-5eclaude-fable-5-2têm cada um uma versão-thinkingcom o mesmo preço.- O grupo de
claude-fable-5-2na tabela geral não inclui Claude_Reverse; fique atento na hora de escolher o grupo e não reaproveite o grupo dos dois modelos Claude anteriores. gpt-6.1-solvem com †, por ter preço escalonado. Texto original da tabela geral: de 0 a 272.000 tokens, entrada a $2/1M; acima de 272.000 tokens, entrada a $4/1M.- Para
gpt-6.1-solegpt-6.1-terra, recomenda-se usar/v1/responses, inclusive para chamadas de ferramentas.
💡 Sugestão de escolha: as reescritas e explicações de terminologia do VibeHub são conversas curtas e não exigem muito do modelo; o que realmente consome tokens são as tarefas longas de escrita de código que vêm depois. Você pode testar alguns modelos com a mesma chave no APIYI apiyi.com, comparar o resultado e a fatura para o mesmo pedido, e só então decidir qual usar no dia a dia.
Se você quiser que o próprio Agent entenda como fazer a integração, dá para empacotar as skills de integração do APIYI dentro do Agent: npx skills add https://docs.apiyi.com. A descrição do pacote de skills está em docs.apiyi.com/skill.md.
Limites de privacidade e riscos ao usar o VibeHub
Os riscos precisam ser vistos em duas camadas: uma é a consulta de termos do VibeHub, e a outra é a invocação do modelo pelo próprio agente.
A camada de consulta de termos do VibeHub: de acordo com o README do repositório, a consulta de termos envia apenas descrições curtas que passam por sanitização programática. Chaves comuns, URLs, e-mails, caminhos locais e blocos de código são removidos antes do envio; não são enviados código-fonte, informações de clientes ou um requisito inteiro. O que vai para vibe-hub.org são apenas termos curtos, como “estado de hover do botão”.
A camada do agente e do modelo: o contexto do projeto que o agente já leu continua sujeito às configurações de privacidade do produto que você usa e do provedor de serviços de modelo. A sanitização do VibeHub cobre apenas as consultas de termos que ele próprio envia e não alcança o conteúdo que o agente envia ao modelo.
- Não cole chaves API na conversa. A chave deve ser colocada na configuração do agente ou em variáveis de ambiente, e não enviada ao modelo como conteúdo de chat.
- A APIYI é um gateway de API. Não é um pool de contas nem uma ferramenta para burlar login; as chamadas seguem o fluxo normal de cobrança da API.
- Faça sua própria verificação antes de entrar em produção. Como diz o verbete Vibe Coding, funcionar não significa ser confiável; você ainda precisa revisar o código, os testes e as permissões.
Perguntas frequentes (FAQ)
Q1: O que é o VibeHub?
O VibeHub (vibe-hub.org) é um glossário de termos de Vibe Coding mantido pelo autor Oil, que explica termos de front-end, back-end e IA em linguagem simples. O VibeHub Skill que o acompanha, quando instalado no Agent, transforma sua linguagem coloquial em requisitos precisos e destaca no máximo 3 termos relacionados a cada vez.
Q2: O VibeHub Skill precisa que eu preencha uma chave API?
Não. O README do repositório diz literalmente “sem conta ou configuração de chave API”; só é necessário Node.js 20 ou superior e um ambiente com internet. Quem precisa de chave é o Modelo de Linguagem Grande chamado pelo seu Agent; essa chave pode usar o token da APIYI (apiyi.com) e não tem relação com o VibeHub.
Q3: Qual é a diferença entre o VibeHub e pedir ao Agent para explicar termos diretamente?
Se você pedir diretamente, o Agent pode falar muita coisa de uma vez ou fornecer links montados por conta própria. O VibeHub determina no máximo 1 a 3 termos por vez, com explicações coladas à tarefa atual, e usa apenas a url retornada pelo parser; se não encontrar, ele avisa e não inventa. Quando a expressão já está precisa, ele também não adiciona explicações à força.
Q4: Para quais cenários o VibeHub é adequado?
– Você quer descrever um efeito de interação, mas não consegue dizer nomes como Hover e Active;
– Você não tem certeza se uma configuração deve virar um Switch de efeito imediato ou ser salva em conjunto;
– A resposta do Agent tem conceitos que você não entende, e isso afeta como você vai responder na próxima frase.
Ele não oferece trilhas de aprendizado nem cursos; se quiser estudar de forma sistemática, pode acessar as seções de cursos e exercícios no site.
Q5: Depois de instalar o VibeHub, como conectar as requisições de modelo do Agent à APIYI?
1. Registre uma conta manualmente em APIYI (apiyi.com), obtenha uma chave API e uma pequena cota de teste;
2. No SDK compatível com OpenAI, preencha base_url com `https://api.apiyi.com/v1`;
3. No SDK nativo da Anthropic, preencha o domínio raiz `https://api.apiyi.com`, sem adicionar `/v1` novamente.
Do lado do VibeHub, não é preciso alterar nenhuma configuração.
Q6: O VibeHub envia meu código para fora?
Segundo o README, a consulta de termos envia apenas uma descrição curta anonimizada; chaves, URLs, e-mails, caminhos locais e blocos de código são removidos antes do envio, e o código-fonte ou o requisito inteiro não é enviado. Porém, o contexto do projeto visto pelo Agent ainda é tratado conforme as regras do provedor de modelo que você escolher; essa parte precisa ser avaliada separadamente.
Q7: Quais são as limitações do VibeHub?
Ele precisa de internet e Node.js 20 ou superior; o escopo de termos é o que está registrado em vibe-hub.org, e termos sem correspondência não são forçados; ele cuida apenas de expressão e terminologia, não decide a abordagem de implementação no seu lugar e nem garante que o código escrito pelo Agent seja confiável.
VibeHub Skill: pontos-chave (Key Takeaways)
- Posicionamento em uma frase: o VibeHub ajusta a linguagem coloquial para o termo certo, e os tokens são gastos no modelo que o Agent invoca.
- Duas formas de instalação: enviar uma mensagem de instalação ao Agent ou executar
npx skills add oil-oil/vibe-hub-skill. - Função 1: padronizar a expressão, preservando a intenção original, sem adicionar frameworks ou parâmetros por conta própria.
- Função 2: sugestões proativas, com no máximo 3 termos realmente relevantes por vez.
- Limite de custos: o Skill não exige chave API, e a consulta de termos não invoca o Modelo de Linguagem Grande.
- Integração com APIYI: para compatibilidade com OpenAI, use
/v1; para Anthropic nativo, use o domínio raiz. - Privacidade em camadas: as consultas de termos passam por anonimização; o contexto do Agent continua indo para o provedor de modelo que você escolher.
Resumo
O VibeHub resolve duas questões no Vibe Coding: «não conseguir descrever com precisão» e «não conseguir entender»:
- Ajustar a linguagem coloquial: por exemplo, «o mouse muda de cor quando passa por cima e dá feedback quando clica» é reescrito como um requisito formado pelos três termos Hover, Active e Transition;
- Na medida certa: no máximo 3 termos por vez, com a explicação colada à tarefa atual, sem virar aula;
- Separar os custos: o Skill em si não cobra chave nem invoca modelo; os tokens são todos gastos nas três etapas do Agent: reescrever, explicar e escrever código.
A instalação leva só uma frase. O que realmente precisa da sua decisão é qual modelo fica por trás do Agent e qual endpoint ele usa. Você pode usar uma chave API no APIYI apiyi.com para comparar alguns dos modelos da tabela acima e então direcionar as requisições do Agent para lá. Modelos e preços seguem a lista de modelos da plataforma.
📚 Materiais de referência
- Site oficial do VibeHub: glossário de termos de Vibe Coding
- Link:
vibe-hub.org -
Descrição: ponto de entrada para termos, exercícios e cursos; a entrada sobre Vibe Coding fica em
vibe-hub.org/vibe-coding -
Página de apresentação do VibeHub Skill: as duas funcionalidades centrais e o texto original das instruções de instalação
- Link:
vibe-hub.org/vibehub-skill -
Descrição: origem dos exemplos de linguagem padronizada e de alertas proativos
-
GitHub – vibe-hub-skill: repositório da Skill
- Link:
github.com/oil-oil/vibe-hub-skill -
Descrição: README e SKILL.md, incluindo formas de consulta, privacidade e limites de configuração
-
Autor Oil: site pessoal e GitHub
- Link:
oiloil.org,github.com/oil-oil -
Descrição: página do autor do VibeHub
-
Tabela geral de modelos da APIYI: modelos, endpoints, grupos e preços
- Link:
docs.apiyi.com/models -
Descrição: dados atualizados em 2026-11-13 12:57 (UTC+8), em dólares por 1 milhão de tokens
-
Entrada da documentação da APIYI e pacote de skills de integração
- Link:
docs.apiyi.com/llms.txt,docs.apiyi.com/skill.md - Descrição: seleção de endpoints, descrição de nós e modos de integração de Agent
Autor: Equipe técnica da APIYI
Contato técnico: fale conosco pela página inicial do site APIYI (apiyi.com); mais materiais de integração estão disponíveis no centro de documentação docs.apiyi.com
