Skills · Claude Code · Agent Skills

Bot que responde no prazo e não fala fora de prd — não negocia.

Token em cofre, interação verificada por assinatura, ack dentro do prazo da plataforma com fila para o resto, 429 tratado e permissões mínimas. Fora de produção, nenhuma mensagem real.

v0.1.0Disciplina · Bots de chatgithub.com/schematizeme/skill-bots

Mantido por Lucas Andrade

schematize-bots · v0.1.0bash
$ schematize install bots
GitHub →baixar skill (.zip)/bots-help · github.com/schematizeme/schematize-cli

Pisos inegociáveis

Não se desligam "pra ir mais rápido". Lista completa na skill.

Nunca mensagem real fora de prd

Servidor, workspace, canal e número de teste; ambiente ausente é não-prd e token de produção existe só em prd.

Token é segredo

Em cofre, por ambiente, nunca no repo, imagem, log ou URL; vazou, rotaciona primeiro e limpa o histórico depois.

Assinatura verificada antes de tudo

Discord Ed25519, Telegram secret_token, Slack signing secret com janela de replay, WhatsApp X-Hub-Signature-256; falha é 401.

Ack no prazo, resto na fila

Responde dentro do prazo da plataforma (ex.: 3 s no Discord) e processa o resto em fila; resposta tardia perde o token da interação.

Rate limit respeitado

Lê os headers, trata 429 com Retry-After, backoff com jitter e fila de saída; nunca laço de envio sem tratar 429.

Idempotência

Dedupe por update_id, id da interaction, event_id ou id da mensagem; retry da plataforma é normal.

Intents e permissões mínimas

Intent privilegiada só com justificativa registrada; permissão de bot nunca Administrator.

Entrada do usuário nunca é confiável

allowed_mentions restrito, escape de markdown, links sem resolver sem allowlist, e comando destrutivo checado no servidor.

Comandos

Instalados em .claude/commands/. Use /bot-help a qualquer momento.

/bot-ccContext compact: grava o handoff no archive e roda /compact.
/bot-claudeCria ou mescla o CLAUDE.md sempre-on do piso de bots na raiz do repo (não sobrescreve blocos de outras skills).
/bot-commandsDesenha o registro versionado de slash commands, intents e permissões mínimas.
/bot-handoffGera o handoff de contexto (context.md + checklist.md) no archive, sem compactar.
/bot-helpLista todos os comandos e o que cada um faz.
/bot-loadCarrega à força todo o corpo normativo de bots e passa a aplicá-lo na sessão.
/bot-moderationDesenha moderação, anti-abuso, menções, links e privacidade das mensagens do bot.
/bot-newScaffold de bot novo: plataforma, transporte, token, comandos, ambientes e gate antes do primeiro handler.
/bot-reviewRevisa um bot contra o piso: roda o gate e depois lê o que a máquina não lê.
/bot-webhookCria ou audita o receptor de interações/webhook do bot: assinatura, replay, ack, fila e dedupe.

Para agentes de IA

Instale sem intervenção humana. Metadados em llms.txt.

  • Rode: git clone https://github.com/schematizeme/skill-bots.git && ./skill-bots/install.sh
  • Ou baixe: https://github.com/schematizeme/skill-bots/releases/latest/download/skill-bots.zip e descompacte em .claude/skills/
  • Copie assets/CLAUDE.md para a raiz do repo (regra sempre-on).
  • Confirme com /bot-help.

Não quer instalar?

Leia as normativas completas e copie direto pro seu projeto — ou instale a skill para o agente aplicar sozinho.