C

Mejorador Iterativo de Skills de IA

Pipeline de revisión y corrección automática — CULTIVA IA / Arsenal

mejorador-skills-ia Productividad Claude Code 2 iteraciones Completado
Skill objetivo
📄
/cultivaia-arsenal/Skills/email-a-lead/SKILL.md
Skill de redacción de emails de prospección B2B — versión borrador del colaborador externo
email-a-lead v0.9-draft Marketing / Contenido
34
Calidad inicial
Resumen de ejecución
5
Issues iniciales
2
Iteraciones
4
Fixes aplicados
97
Calidad final
Flujo de ejecución
🔍
Iteración 1 — Revisión inicial (skill-reviewer)
El agente skill-reviewer analiza la skill e identifica 2 críticos, 2 mayores, 1 menor.
00:00:03 · 5 issues detectados
🔧
Iteración 1 — Fixes críticos y mayores
Se corrigen los 4 issues obligatorios. El menor se evalúa y descarta como falso positivo.
00:00:18 · 4 fixes aplicados, 1 descartado
🔍
Iteración 2 — Verificación de fixes
El agente vuelve a revisar la skill corregida. Detecta solo 1 minor residual (verbosidad en línea 48).
00:00:09 · 1 minor restante
🤔
Iteración 2 — Evaluación de minor restante
La verbosidad en línea 48 es intencional: provee contexto necesario para el modelo. Se descarta como no crítico.
00:00:05 · Evaluado → no aplicar
Completado — Marcador emitido
Todos los issues críticos y mayores resueltos. El marcador de stop detiene el bucle.
00:00:35 total · Skill aprobada para catálogo
Iteración 1 — Revisión skill-reviewer
Issues detectados
CRÍTICO
Campo requerido name ausente en el frontmatter YAML
SKILL.md:1 — frontmatter
CRÍTICO
Referencia a templates/email.md que no existe en el directorio
SKILL.md:34 — ruta rota
MAYOR
Description usa segunda persona: "deberías usar esta skill cuando…" en lugar de imperativo
SKILL.md:6 — voz incorrecta
MAYOR
Falta la sección "When NOT to Use" obligatoria por estándares de calidad
SKILL.md — sección faltante
MENOR
El ejemplo de email en línea 68 es demasiado genérico (podría ser más específico al sector)
SKILL.md:68 — sugerencia estilo
Fixes aplicados
Añadido campo name: Insertado name: email-a-lead en posición 1 del frontmatter YAML
Ruta corregida: Creado templates/email.md con estructura base, referencia ahora válida
Voz corregida: "deberías usar esta skill cuando…" → "Usar cuando se necesite redactar un email…" (imperativo)
Sección añadida: Insertada "When NOT to Use" con 4 casos de exclusión claros y accionables
[DESCARTADO — MINOR] El ejemplo en línea 68 es deliberadamente genérico para aplicar a múltiples sectores. Falso positivo del reviewer.
📝 SKILL.md — diff principal (iter 1)
--- email-a-lead/SKILL.md (antes)
+++ email-a-lead/SKILL.md (después)
 ---
+name: email-a-lead
-description: Deberías usar esta skill cuando quieras escribir emails de prospección B2B
+description: Redactar emails de prospección B2B personalizados con estructura probada. Usar cuando se necesite un email de primer contacto para un lead frío.
 allowed-tools: Read Write Edit
 ---
 
 # Email a Lead B2B
 
-Ver plantilla en templates/email.md para el formato.
+Ver plantilla en [templates/email.md](templates/email.md) para el formato base.
 
 ## When to Use
 - Primer contacto con lead frío identificado
 - Seguimiento post-evento o webinar
 
+## When NOT to Use
+- Leads que ya están en conversación activa con el equipo de ventas
+- Clientes existentes (usar skill `upsell-email` en su lugar)
+- Emails masivos sin personalización (usar secuencia de drip en lugar)
+- Contactos que han solicitado no recibir comunicaciones comerciales
Iteración 2 — Verificación y cierre
Issues residuales
MENOR
Línea 48 es verbose: el párrafo explicativo podría resumirse en una sola frase
SKILL.md:48 — estilo
Evaluación minor
[DESCARTADO] La línea 48 explica el razonamiento detrás del tono elegido para el email. Esta verbosidad es intencional: mejora la comprensión del modelo al ejecutar la skill y reduce errores de tono. No es un false positive del reviewer, pero el beneficio de resumir es mínimo frente al riesgo de perder contexto útil. Decisión: mantener.
Resultado final
🏆
Todos los issues críticos y mayores resueltos
Skill aprobada para publicación en catálogo CULTIVA IA
97
Calidad final
🏁 <skill-improvement-complete>
Fixes críticos aplicados:
✅ Campo name en frontmatter
✅ Ruta templates/email.md creada y válida
Fixes mayores aplicados:
✅ Description en voz imperativa
✅ Sección "When NOT to Use" añadida
Evolución de calidad
Antes Después
Frontmatter válido
20%
100%
Rutas referenciadas
0%
100%
Voz imperativa
40%
100%
Secciones requeridas
50%
100%
Descripción del trigger
30%
95%