Preámbulo (se ejecuta al iniciar el skill)
# Verificación de versión (silenciosa si está actualizada)
python3 telemetry/version_check.py 2>/dev/null || true
# Aceptación de telemetría (solo la primera vez, luego recuerda tu elección)
python3 telemetry/telemetry_init.py 2>/dev/null || true
Privacidad: Este skill registra el uso localmente en
~/.ai-marketing-skills/analytics/. La telemetría remota es solo por aceptación explícita. Nunca se recopilan códigos, rutas de archivos ni contenido del repositorio. Consultetelemetry/README.md.
Panel de Expertos
Motor de puntuación y mejora iterativa de propósito general. Ensambla automáticamente los expertos adecuados para lo que se esté evaluando, lo puntúa y repite hasta alcanzar 90+.
Paso 1: Recepción — Comprender lo que se va a puntuar
Recopilar o inferir del contexto:
- Contenido/artefacto — La(s) cosa(s) a puntuar (pegar, ruta de archivo o URL)
- Tipo de contenido — Copia, secuencia, página de aterrizaje, estrategia, título, gráfico, evaluación de candidato, etc.
- Contexto de la oferta — ¿Qué se está vendiendo/promocionando? ¿A quién? ¿Qué dominio/industria?
- Variantes — ¿Hay múltiples versiones para comparar? (A/B/C)
- Skill de origen — ¿Es esta salida de otro skill? (por ejemplo, optimizador-de-outbound-frío) Si es así, anote el origen para la retroalimentación al origen en el Paso 6.
Si el contexto es obvio a partir de la conversación, no pregunte — simplemente continúe.
Paso 2: Autoensamblaje del Panel de Expertos
Construya un panel de 7 a 10 expertos adaptado al tipo de contenido y dominio.
Reglas de ensamblaje
-
Comience con expertos en tipo de contenido. Lea el directorio
experts/para paneles preconstruidos que coincidan con el tipo de contenido. Si existe una coincidencia exacta (por ejemplo,experts/linkedin.mdpara una publicación de LinkedIn), utilícela como base. -
Agregue expertos en dominio/oferta. Según el contexto de la oferta, agregue 1 a 3 expertos que comprendan la industria o el dominio específico. Ejemplos:
- Puntuar marketing de panadería → agregue Experto en Marketing de Alimentos y Bebidas
- Puntuar página de aterrizaje SaaS → agregue Experto en Conversión SaaS
- Puntuar alcance de reclutamiento → agregue Reclutador de Agencia + Experto en Mercado Laboral
- Puntuar copia de dispositivo médico → agregue Experto en Cumplimiento Sanitario
-
Incluya siempre estos dos:
- Detector de Escritura AI — Consulte
experts/humanizer.md. Peso: 1.5x. No negociable. - Coincidencia de Voz de Marca — Verifica la alineación con la voz de marca configurada y los patrones de rechazo conocidos de
references/patterns.md(si existe).
- Detector de Escritura AI — Consulte
-
Verifique patrones aprendidos. Si
references/patterns.mdexiste, léalo. Si algún patrón se aplica a este tipo de contenido, informe al panel sobre ellos. Descuente puntos por patrones conocidos como malos. -
Límite de 10 expertos. Si tiene más de 10, fusione roles superpuestos.
Formato de salida del panel
Enumere cada experto con: Nombre, enfoque/lente, qué verifican.
Paso 3: Seleccionar Rúbrica de Puntuación
Elija la rúbrica adecuada de scoring-rubrics/:
| Tipo de contenido | Archivo de rúbrica |
|---|---|
| Blog, redes sociales, correo, boletín, guiones | scoring-rubrics/content-quality.md |
| Estrategia, recomendaciones, análisis | scoring-rubrics/strategic-quality.md |
| Páginas de aterrizaje, anuncios, CTA | scoring-rubrics/conversion-quality.md |
| Gráficos, visualización de datos, infografías | scoring-rubrics/visual-quality.md |
| Evaluaciones de candidatos | scoring-rubrics/evaluation-quality.md |
| Otros | Sintetice una rúbrica a partir de las dos coincidencias más cercanas |
Lea el archivo de rúbrica seleccionado para obtener criterios detallados y asignación de puntos.
Paso 4: Puntuar — Bucle Recursivo Hasta 90+
Objetivo: 90/100 en todos los expertos. No negociable. Máximo 3 rondas.
Cada ronda produce:
## Ronda [N] — Puntuación: [MEDIA]/100
| Experto | Puntuación | Comentarios clave |
|---------|------------|-------------------|
| [Nombre] | [0-100] | [Justificación de una línea] |
| ... | ... | ... |
**Agregado:** [media ponderada — humanizador al 1.5x]
**Principales 3 debilidades:** [clasificadas]
**Cambios realizados:** [ediciones específicas que abordan cada debilidad]
Luego el contenido/artefacto revisado.
Reglas
- Las puntuaciones deben ser brutalmente honestas. Sin inflar a 90.
- La puntuación del humanizador se pondera al 1.5x en el agregado.
- Si el agregado < 90: identifique las 3 principales debilidades → revise → siguiente ronda.
- Si el agregado ≥ 90: finalice y proceda a la salida.
- Después de 3 rondas, si aún < 90: devuelva la mejor versión con puntuación honesta + nota sobre lo que la está frenando.
- Muestre TODAS las rondas en la salida — el rastro de iteración es parte del valor.
Modo de comparación de variantes
Al puntuar múltiples variantes (A/B/C):
- Puntúe cada variante de forma independiente a través del panel completo.
- Después de la puntuación, clasifique las variantes por puntuación agregada.
- Si la mejor variante es < 90, itere sobre la mejor (no itere todas).
Paso 5: Formato de Salida
Ganador + Puntuación (siempre al principio)
## 🏆 Resultado: [PUNTUACIÓN]/100 — [APROBADO ✅ | NECESITA TRABAJO ⚠️]
[Contenido/artefacto final aquí]
**Iteraciones:** [N] rondas
**Panel:** [Nombres de expertos, separados por comas]
Si hay variantes: muestre primero el ganador, luego las puntuaciones de los subcampeones.
## 🏆 Ganador: Variante [X] — [PUNTUACIÓN]/100
[Contenido ganador]
### Puntuaciones de subcampeones
- Variante A: 87/100
- Variante B: 82/100
- Variante C: 91/100 ← Ganador
Historial de Comentarios (debajo del resultado)
Muestre las rondas de puntuación completas.
---
<details>
<summary>📊 Historial de Puntuación (N rondas)</summary>
[Todas las tablas de ronda del Paso 4]
</details>
Paso 6: Retroalimentación al Origen (Al Puntuar la Salida de Otro Skill)
Cuando el contenido puntuado proviene de otro skill, genere un Informe de Mejora de Origen:
## 🔁 Comentarios para [Skill de Origen]
### Lo que puntuó bajo
- [Patrón]: [Ejemplo específico de este contenido]
### Mejoras sugeridas para el skill
- [Cambio concreto en el proceso/rúbrica/prompt del skill de origen]
### Patrones para agregar al skill de origen
- [Cualquier debilidad recurrente que deba convertirse en regla]
Este informe se puede utilizar para actualizar el SKILL.md o las rúbricas del skill de origen.
Paso 7: Memoria — Aprender de Aprobaciones y Rechazos
Después de que el usuario apruebe o rechace la salida del panel:
En caso de aprobación (puntuación ≥ 90, usuario acepta)
Anote lo que funcionó. No se requiere acción a menos que surja un nuevo patrón positivo.
En caso de rechazo (el usuario anula el panel o rechaza contenido con 90+)
- Pregunte por qué (o infiera del contexto).
- Agregue un nuevo patrón a
references/patterns.mdusando este formato:
## [Nombre del Patrón]
- **Tipo:** rechazo | preferencia | anulación
- **Tipos de contenido:** [a qué tipos se aplica esto]
- **Regla:** [Qué hacer siempre/nunca]
- **Ejemplo:** [La instancia específica que desencadenó esto]
- **Fecha:** [AAAA-MM-DD]
- **Descuento de puntos:** [-N puntos cuando se detecte]
- Confirme: "Patrón agregado: [resumen de una línea]. El panel descontará [N] puntos por esto en adelante."
Aplicación de patrones
En cada ronda de puntuación, verifique references/patterns.md contra el contenido. Aplique descuentos de puntos antes de que comience la puntuación de los expertos. Esto significa que los patrones conocidos como malos se penalizan incluso si los expertos individuales no los detectan.
Archivos de Referencia
| Archivo | Propósito | Cuándo leerlo |
|---|---|---|
experts/humanizer.md | Rúbrica de detección de escritura AI (24 patrones) | Cada ejecución de puntuación |
experts/[dominio].md | Paneles de expertos preconstruidos para dominios comunes | Cuando el dominio coincida |
scoring-rubrics/content-quality.md | Rúbrica de puntuación de contenido | Puntuación de contenido |
scoring-rubrics/strategic-quality.md | Rúbrica de puntuación de estrategia | Puntuación de estrategia |
scoring-rubrics/conversion-quality.md | Rúbrica de página de aterrizaje/anuncio/CTA | Puntuación de conversión |
scoring-rubrics/visual-quality.md | Rúbrica de gráficos/visualización de datos/infografías | Puntuación visual |
scoring-rubrics/evaluation-quality.md | Rúbrica de candidatos/evaluación | Puntuación de evaluación |
references/patterns.md | Patrones de rechazo aprendidos | Cada ejecución de puntuación |
references/expert-assembly.md | Ejemplos de expertos de dominio para autoensamblaje | Al construir paneles desconocidos |