Hub de Skills: governança de IA na InBot
Meu papel
Sou AI Enablement Lead & Frontend Tech Lead na InBot. Construí o front e o back do hub e defini o fluxo de publicação com a equipe de IA.
Uma skill de IA é código que roda na máquina de quem a recebe. Por isso, distribuir skills para a empresa inteira é, antes de tudo, um problema de governança. O Hub de Skills é a peça central da área de AI Enablement que fundei na InBot: é por ele que cada time recebe, publica e atualiza as skills que usa no Claude Code e no Codex.
Login corporativo: tudo passa pelo SSO da empresa (Keycloak), e cada pessoa só vê e recebe as skills das próprias equipes.
Homologação e produção: cada skill tem versão de homologação e de produção; quem tem acesso testa antes de a versão chegar a todos.
Revisão obrigatória: nenhuma publicação vai direto para as máquinas, nem a do root. O envio vira PR e passa pela revisão da equipe de IA.
Instalador assinado: o instalador para Linux, macOS e Windows tem a assinatura conferida antes do download e mantém as skills atualizadas sozinho.
Publicação por zip: o autor envia a pasta da skill, vê a prévia com o diff e escolhe o destino; os campos de governança que faltam no SKILL.md são completados automaticamente.
Sistema interno da InBot: o código é proprietário e os prints usam dados fictícios.
Antes
Hub aberto, protegido só por uma senha de administrador: qualquer pessoa com o link via tudo, sem autor, revisão nem versão rastreáveis.
O problema
Antes de eu assumir a governança das skills, o hub da InBot era aberto. Só a área de administração tinha senha: qualquer pessoa com o link via tudo. As skills subiam como zip, na mão, sem sincronizar com o GitHub, e as máquinas atualizavam usando um token do GitHub. Não dava para saber quem tinha publicado o quê, nem garantir que o arquivo instalado era o mesmo que tinha sido revisado.
Como uma skill roda na máquina de quem a recebe, isso era um problema de segurança.
A solução
Reconstruí o hub sobre o login corporativo (Keycloak), com a regra "ver = receber": cada pessoa vê exatamente as skills que o instalador coloca na máquina dela, e só as da própria equipe. A publicação virou um fluxo com prévia e diff, destino em homologação (branch stg) ou produção (PR na main) e revisão obrigatória da equipe de IA.
Para garantir que o arquivo instalado é o revisado, as releases levam uma assinatura humana, feita com chave SSH. O computador de quem instala confere essa assinatura e, se o arquivo não estiver assinado, não instala. O front é React + TypeScript; o backend é Convex, compartilhado com a CLI de atualização usada pelas pessoas no terminal.
Decisões e trade-offs
Login corporativo (Keycloak) no lugar da senha compartilhada, com a regra "ver = receber": cada pessoa vê só o que o instalador entrega a ela. Releases assinadas, conferidas pelo instalador antes de instalar. Publicação separada entre homologação (branch stg) e produção (PR na main), sempre com revisão da equipe de IA.
Os resultados
O hub virou a porta única de entrada das skills da empresa, com cerca de 50 skills e automações em produção e 77 iniciativas da área de AI Enablement entregues em 4 meses. Toda publicação agora tem autor, revisão e versão rastreáveis.
Antes ele era só um lugar para subir arquivo; agora tem telemetria de uso de cada skill, logs e permissões por equipe. A telemetria já está mostrando como as pessoas usam as skills e onde vale focar a atenção.
Resultados em números
- ~50Skills em produção
- 3Sistemas operacionais
- Claude Code + CodexAgentes atendidos
- 100%Publicações com revisão