Skills · Claude Code · Agent Skills

Un bot que responde a tiempo y no habla fuera de prd: sin negociar.

Token en bóveda, cada interacción verificada por firma, ack dentro del plazo de la plataforma con cola para el resto, 429 gestionado y permisos mínimos. Fuera de producción, ningún mensaje real.

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

Mantenido por Lucas Andrade

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

Pisos innegociables

No se apagan "para ir más rápido". Lista completa en la skill.

Nunca un mensaje real fuera de prd

Servidor, workspace, canal y número de prueba; un entorno ausente es no-prd y el token de producción existe solo en prd.

El token es un secreto

En bóveda, por entorno, nunca en el repo, la imagen, el log o la URL; si se filtra, rota primero y limpia el historial después.

Firma verificada antes de todo

Discord Ed25519, Telegram secret_token, Slack signing secret con ventana de replay, WhatsApp X-Hub-Signature-256; el fallo es un 401.

Ack a tiempo, el resto en cola

Responde dentro del plazo de la plataforma (p. ej. 3 s en Discord) y procesa el resto en una cola; una respuesta tardía pierde el token de la interacción.

Rate limit respetado

Lee las cabeceras, trata el 429 con Retry-After, backoff con jitter y cola de salida; nunca un bucle de envío sin tratar el 429.

Idempotencia

Dedupe por update_id, id de la interaction, event_id o id del mensaje; los reintentos de la plataforma son normales.

Intents y permisos mínimos

Un intent privilegiado solo con justificación registrada; el permiso del bot nunca es Administrator.

La entrada del usuario nunca es de fiar

allowed_mentions restringido, escape de markdown, enlaces sin resolver sin allowlist y comandos destructivos validados en el servidor.

Comandos

Instalados en .claude/commands/. Usa /bot-help en cualquier momento.

/bot-ccContext compact: guarda el handoff en el archive y ejecuta /compact.
/bot-claudeCrea o fusiona el CLAUDE.md siempre activo del piso de bots en la raíz del repo (no sobrescribe bloques de otras skills).
/bot-commandsDiseña el registro versionado de slash commands, intents y permisos mínimos.
/bot-handoffGenera el handoff de contexto (context.md + checklist.md) en el archive, sin compactar.
/bot-helpLista todos los comandos y lo que hace cada uno.
/bot-loadCarga a la fuerza todo el cuerpo normativo de bots y empieza a aplicarlo en la sesión.
/bot-moderationDiseña la moderación, el anti-abuso, las menciones, los enlaces y la privacidad de los mensajes del bot.
/bot-newScaffold de un bot nuevo: plataforma, transporte, token, comandos, entornos y gate antes del primer handler.
/bot-reviewRevisa un bot contra el piso: ejecuta el gate y luego lee lo que la máquina no lee.
/bot-webhookCrea o audita el receptor de interacciones/webhook del bot: firma, replay, ack, cola y dedupe.

Para agentes de IA

Instala sin intervención humana. Metadatos en llms.txt.

  • Ejecuta: git clone https://github.com/schematizeme/skill-bots.git && ./skill-bots/install.sh
  • O descarga: https://github.com/schematizeme/skill-bots/releases/latest/download/skill-bots.zip y descomprime en .claude/skills/
  • Copia assets/CLAUDE.md a la raíz del repo (regla siempre activa).
  • Confirma con /bot-help.

¿No quieres instalar?

Lee las normas completas y cópialas directo a tu proyecto — o instala la skill para que el agente las aplique solo.