Guías del asistente

Tu asistente de código ya sabe trabajar en DeskcommCRM.

Son seis guías que enseñan a Claude Code, Codex, Cursor, Antigravity y OpenCode a instalar el CRM, configurar un cliente, leer las métricas, afinar el agente de IA y contribuir con el código — siguiendo las reglas del proyecto. No tienes que memorizar nombres: di lo que quieres y la guía correcta entra sola.

curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/scripts/instalar-guias.sh | bash

Cómo funciona

  1. 1

    Instala una vez

    Un comando deja las guías disponibles en cualquier carpeta de tu computadora, para todos los asistentes.

  2. 2

    Abre una sesión nueva

    Los asistentes leen las guías cuando empieza la sesión. Una conversación que ya estaba abierta no ve lo que acaba de llegar.

  3. 3

    Pide a tu manera

    “El agente está respondiendo mal.” El asistente reconoce el tema y sigue la guía. Si prefieres, llámala por su nombre.

Las guías

Una guía para cada trabajo.

Cuatro son para quien instala y opera el CRM, y no exigen saber programar. Dos son para quien trabaja en el código.

Instalar y operar

/deskcomm-instalar

Para quien usa el CRM

Pone el CRM en línea en un VPS y lo cuida después: actualizaciones, respaldos, dominio, WhatsApp y los errores de instalación.

Qué hace

  • Guía la instalación paso a paso y ejecuta los scripts del kit.
  • Resuelve SSL, DNS, Supabase, proxy y clave de IA.
  • Actualiza, respalda y restaura.

Pídelo así

  • quiero instalar el CRM en mi VPS
  • mi sitio no tiene el candado
  • ¿cómo hago un respaldo?

Para quién: Quien instala, aunque no sea técnico, agencias y quien opera un VPS.

Ver la guía en GitHub

Configurar un cliente

/deskcomm-cliente-novo

Para quien usa el CRM

Arma la atención de un cliente según su nicho — clínica, inmobiliaria, servicios, cursos, tienda — en el orden correcto y desde la pantalla.

Qué hace

  • Crea agentes de IA, enrutadores y seguimientos.
  • Sube la base de conocimiento y arma el embudo.
  • Te da el texto listo para pegar y te guía hasta la prueba.

Pídelo así

  • configura el CRM para una clínica
  • ¿qué prompt uso en el agente de la inmobiliaria?
  • terminé el onboarding, ¿y ahora?

Para quién: Dueños de negocio, agencias y quien implementa para terceros.

Ver la guía en GitHub

Analizar las métricas

/deskcomm-metricas

Para quien usa el CRM

Lee la operación como un analista experimentado: conversión, embudo, tiempo de respuesta, paso a humano y costo de IA.

Qué hace

  • Muestra dónde se traba el embudo y por qué cayó la conversión.
  • Dice cuánto cuesta la IA y a qué hora escriben más los clientes.
  • Declara la regla y la zona horaria de cada número.

Pídelo así

  • ¿el agente está vendiendo?
  • ¿por qué cayó la conversión?
  • ¿cuánto estoy gastando en IA?

Para quién: Dueños de negocio, agencias y operadores.

Ver la guía en GitHub

Afinar el agente de IA

/deskcomm-prompt

Para quien usa el CRM

Mejora el prompt de un agente que no está rindiendo, como un ingeniero de prompts sénior — con los datos de la operación.

Qué hace

  • Diagnostica por las ejecuciones, bloqueos y costos del agente.
  • Escribe la nueva versión como borrador y la prueba con el botón Probar.
  • Deja el Publicar en tus manos.

Pídelo así

  • el agente suena robótico
  • inventa precios
  • mejora el prompt del agente de ventas

Para quién: Dueños de negocio, agencias e implementadores.

Ver la guía en GitHub

Contribuir con código

/deskcomm-contribuir

Para quien programa

Revisa antes del pull request lo que el mantenedor revisa después — y evita retrabajo y PR rechazados.

Qué hace

  • Avisa cuando tu rama está atrasada respecto a main.
  • Pide la migración, la prueba que falta y el fragmento de release.
  • Muestra cómo probar el cambio en pantalla.

Pídelo así

  • voy a abrir un PR
  • ¿mi rama está atrasada?
  • ¿por qué el CI quedó en rojo?

Para quién: Quien contribuye, sobre todo desde un fork, y devs de agencia.

Ver la guía en GitHub

Seguir las reglas del código

/deskcomm-doutrina

Para quien programa

Señala las reglas no negociables de este repositorio cada vez que alguien escribe o revisa código.

Qué hace

  • Aislamiento entre empresas con RLS.
  • Migración, baseline y manifiesto andando juntos.
  • Qué cambia para quien ya instaló en un VPS.

Pídelo así

  • revisa este código
  • ¿cómo creo una migración aquí?
  • ¿puedo agregar esta columna?

Para quién: Cualquier persona o IA que escriba código en el proyecto.

Ver la guía en GitHub

En tu asistente

Cómo usarlas en cada uno.

Todos siguen el mismo estándar abierto de guías (Agent Skills) y activan la guía solos según el tema. Cambia dónde buscan y cómo llamar una guía por su nombre.

Dónde busca

En la carpeta .claude/skills del proyecto y en tu carpeta personal.

  • Proyecto.claude/skills/
  • Global~/.claude/skills/
Por su cuenta
Lee la descripción de cada guía y activa la que coincide con tu pedido.
Por nombre

Escribe la barra y el nombre. Lo que escribas después se le pasa a la guía.

/deskcomm-instalar mi dominio es crm.miempresa.com
Ver la lista

Muestra todas las guías cargadas.

/skills

¿Otro asistente? Los que siguen el estándar Agent Skills — como GitHub Copilot y Gemini CLI — suelen leer la carpeta .agents/skills, y el instalador también enlaza las guías en ~/.agents/skills.

Instalar

Dos formas de tener las guías.

Si todavía no clonaste el proyecto, o trabajas desde otra carpeta, usa el instalador. Si estás en un clon actualizado, ya tienes todo.

En cualquier carpeta

Recomendado

Pégalo en la terminal de tu computadora — no en el VPS. Funciona antes de clonar el proyecto.

curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/scripts/instalar-guias.sh | bash
  • Guarda una copia solo de las guías en ~/.deskcomm/guias.
  • Enlaza cada guía en las carpetas que leen los asistentes: ~/.claude/skills, ~/.agents/skills y ~/.gemini/config/skills.
  • Nunca borra una skill tuya con el mismo nombre: avisa y la salta.

Para actualizar, ejecuta el mismo comando otra vez.

Para deshacer:

curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/scripts/instalar-guias.sh | bash -s -- --remover

Dentro de un clon

Las guías viven en el propio repositorio. Abre el asistente en la carpeta del proyecto y ya están ahí.

git clone https://github.com/melgarafael/DeskcommCRM.git
cd DeskcommCRM
  • Están en .agents/skills, con una copia en .claude/skills para Claude Code.
  • Mantén tu rama actualizada con main: en una rama vieja, las guías también son viejas.

En Windows, ejecútalo desde Git Bash si el asistente está instalado en el propio Windows. Desde WSL, solo si el asistente también corre dentro de WSL: ahí tu carpeta personal es la de Linux, que los programas de Windows no leen. Donde el sistema no crea enlaces de carpeta, el instalador copia las guías — entonces vuelve a ejecutar el comando cada vez que quieras actualizar.

Para quien contribuye

Cambiar una guía.

Las guías son código del proyecto: entran por pull request y tienen pruebas.

  1. 1

    Edita la fuente

    El archivo es .agents/skills/<guía>/SKILL.md. Deja la descripción del encabezado entre comillas: dos puntos sueltos rompen los lectores estrictos, y la guía desaparece sin aviso.

  2. 2

    Actualiza el espejo

    Copia las guías a .claude/skills, la carpeta de Claude Code.

    pnpm skills:sync
  3. 3

    Ejecuta la prueba

    Reprueba un encabezado inválido, un espejo desactualizado y una descripción demasiado larga.

    pnpm test:unit tests/unit/skills-embutidas.test.ts
  4. 4

    Prueba tu versión

    En Claude Code, una guía instalada de forma global le gana a la del proyecto. Apunta el instalador a tu clon antes de probar.

    bash scripts/instalar-guias.sh --fonte .

Preguntas frecuentes

¿Necesito saber el nombre de la guía?

No. El asistente elige la guía según lo que pides. El nombre sirve cuando quieres estar seguro de qué guía va a entrar.

¿El asistente va a cambiar mi servidor solo?

Sigue los permisos de tu asistente: los comandos piden tu confirmación, salvo que los hayas liberado. En la guía de prompt, publicar la nueva versión del agente siempre queda en tus manos.

¿Las guías leen las conversaciones de mis clientes?

La de métricas, no: lee la base solo con consultas que suman y cuentan, sin abrir el texto de los mensajes ni datos personales. La de prompt puede leer un fragmento cuando es indispensable para ver cómo habla el agente, y solo con tu conocimiento: los mensajes que el propio agente envió en pocas conversaciones recientes — no los del cliente —, sin copiar nada fuera de la sesión.

¿Funciona si escribo en español o en inglés?

Sí. Las guías están escritas en portugués, y el asistente las sigue y te responde en el idioma en que escribes.

Ya tengo una skill con el mismo nombre. ¿Y ahora?

El instalador no la toca: avisa que la saltó y sigue con las otras guías.

Instalé y la guía no aparece.

Abre una sesión nueva del asistente. En Antigravity, confirma también que confías en la carpeta del proyecto: ahí, una carpeta no confiable no carga sus guías.