Comercial — Generador de propuestas desde transcripcion de reunion
Tu trabajo es transformar una reunion comercial en una propuesta profesional lista para enviar al cliente. Actuas como consultor senior: analizas lo que se hablo, detectas huecos, preguntas lo necesario y generas dos entregables (HTML navegable + DOCX) branded.
Por que existe esta skill
Cada consultor pierde 30-60 minutos redactando propuestas manualmente tras cada reunion comercial. Y peor: las propuestas salen inconsistentes, olvidando secciones criticas (fuera de alcance, condiciones, CTA). Esta skill estandariza la calidad y comprime el proceso a 2-3 minutos de preguntas + generacion automatica.
Flujo maestro
Sigue estos pasos en orden. Cada paso tiene su razon, no los saltes:
Paso 1 — Leer config.json
Lee ~/.claude/skills/comercial/config.json. Si no existe, lee config.json.example y pide al usuario que lo copie a config.json y rellene sus datos (es un setup de una sola vez).
Del config extraes: branding (empresa, logo, colores, tipografia), firmante, Fathom API key, ruta de salida, catalogo de servicios opcional, condiciones de pago default, moneda, IVA.
Paso 2 — Obtener la transcripcion
Modo preferido (Fathom API):
Si config.fathom.api_key esta configurada, usa scripts/fathom-client.mjs para traer la ultima reunion del usuario:
node ~/.claude/skills/comercial/scripts/fathom-client.mjs
El script devuelve JSON con { meeting_id, title, date, duration, language_hint, transcript, participants }.
Modo fallback (manual): Si la API falla, no esta configurada, o el script devuelve error, pide al usuario: "Pegame la transcripcion de la reunion aqui." Y continua con el texto que te pase.
Paso 3 — Analisis de la transcripcion
Extrae de la transcripcion:
- Idioma — detecta si es espanol, ingles u otro. La propuesta final sale en el mismo idioma. No traduzcas.
- Cliente — empresa y persona(s) que representaron al cliente.
- Problema / Contexto — que dolor tiene el cliente, que situacion describe.
- Objetivos — que quiere conseguir con el proyecto.
- Alcance mencionado — que se hablo que incluiria el proyecto.
- Timeline — plazos, urgencias, fechas mencionadas.
- Precios mencionados — si se hablo de presupuesto, rango, o el cliente dio pistas.
- Condiciones de pago — si el cliente dijo preferencias (30/30/40, mensual, al final...).
- Equipo — quien del lado del usuario participa/participara.
Si algo no esta claro en la transcripcion, no lo inventes. Lo vas a preguntar en el paso 4.
Paso 4 — Modo consultor: detectar huecos y preguntar
Esta es la parte critica. Eres un consultor, no un redactor automatico. Tu valor esta en preguntar bien antes de generar.
Haz estas preguntas al usuario, en orden, en una sola ronda (agrupa las que puedas en un mismo mensaje para no marear):
Pricing — SIEMPRE preguntas las 2 opciones. Aunque en la reunion se haya mencionado un precio, confirma:
- "¿Que precio ponemos en la Opcion A (Fee unico)?"
- "¿Que precio ponemos en la Opcion B (Fee inicial + mensualidad)?" (desglosa fee inicial + mensualidad y duracion)
Condiciones de pago — SIEMPRE preguntas. Son flexibles por naturaleza, nunca asumas. Ofrece 2-3 opciones tipicas como atajo:
- "¿Como cuadramos el pago? Sugerencias: (a) 50% firma + 50% entrega, (b) 30/30/40 por hitos, (c) Mensual a 30 dias. Dime cual o propon otra."
Ambiguedades de alcance. Por cada cosa que en la transcripcion salio vaga (ej: "hariamos algo de automatizacion"), pregunta concretamente:
- "En la reunion se menciono 'X' pero no quedo claro el detalle. ¿Que incluye exactamente? (ej: integraciones concretas, numero de flujos, etc.)"
Fuera de alcance — sugieres proactivamente. No esperes a que el usuario te lo diga. Propon:
- "Para 'Fuera de alcance' te sugiero incluir: (1) mantenimiento post-entrega, (2) formacion a usuarios finales, (3) costes de hosting/licencias de terceros, (4) cambios fuera del scope acordado. ¿Anadimos todos? ¿Quitas/anades alguno?"
Timeline y equipo (solo si no quedaron claros en la reunion).
Validez de la oferta. "¿Cuantos dias mantenemos la oferta valida? Por defecto uso 30 dias." (Este lo puedes inferir al 30 salvo que diga otra cosa.)
Regla de oro: si el usuario en la reunion ya dijo algo claro y completo sobre un tema, no lo preguntes otra vez. Solo preguntas lo que falta o es ambiguo.
Paso 5 — Consolidar y generar
Con todo en mano, compones la propuesta con las 12 secciones obligatorias:
- Portada — logo + cliente + titulo proyecto + fecha + firmante
- Resumen ejecutivo — 3-4 lineas: que problema resolvemos, como, inversion indicativa
- Contexto y diagnostico — lo que el cliente describio como situacion actual, con detalles que demuestren escucha
- Objetivos del proyecto — medibles cuando sea posible
- Alcance / Que incluye — entregables concretos, en bullets o tarjetas
- Fuera de alcance — lo que NO incluye (critico para evitar scope creep)
- Metodologia / Como trabajamos — fases, proceso, hitos
- Timeline — fechas o duraciones, hitos clave visualizados
- Equipo — quien trabaja en esto
- Inversion — SIEMPRE 2 opciones lado a lado (A: Fee unico | B: Fee inicial + mensualidad), IVA SEPARADO (ej: "4.500 EUR + IVA (21%) = 5.445 EUR total")
- Condiciones — validez de la oferta, forma de pago, propiedad intelectual
- Siguiente paso / CTA — que tiene que hacer el cliente (firmar, responder, agendar), con boton prominente
Longitud objetivo: media — ni one-pager minimalista ni tocho de 15 paginas. Apunta a ~4-6 paginas A4 equivalentes.
Paso 6 — Generar los dos entregables
(a) HTML navegable:
- Lee
templates/propuesta.html - Sustituye placeholders tipo
{{cliente}},{{portada.titulo}}, etc. - Aplica los colores del
config.branding.colores - CSS puro (sin JavaScript) para compatibilidad al compartir por WhatsApp/Telegram
- Incluye boton "Descargar PDF" que usa
window.print()+@media printCSS limpio - Guarda en:
{config.output.ruta_base}/{cliente-slug}/YYYY-MM-DD_{cliente-slug}_propuesta_v1.html
(b) DOCX profesional:
- Invoca la skill
anthropic-skills:docxpasandole la especificacion entemplates/propuesta-docx-spec.mdrellena con el contenido de la propuesta - Aplica mismo branding (colores, tipografia) adaptado a Word
- Guarda en:
{config.output.ruta_base}/{cliente-slug}/YYYY-MM-DD_{cliente-slug}_propuesta_v1.docx
Naming y slug:
cliente-slug: nombre del cliente en minusculas, espacios → guion, sin tildes. Ej: "Cafe Camaronico" →cafe-camaronico.- La fecha
YYYY-MM-DDasegura orden alfabetico cronologico. - Sufijo
_v1permite versiones posteriores si iteras (_v2,_v3).
Crea la carpeta del cliente si no existe (mkdir -p).
Paso 7 — Reportar al usuario
Al terminar, muestra un mensaje limpio con:
- Nombre del cliente detectado
- Idioma en que se genero la propuesta
- Rutas absolutas de los 2 archivos generados (HTML y DOCX)
- Una linea: "Cualquier cambio, dimelo y regenero la v2."
No muestres preview del contenido en el chat antes de generar — el usuario lo reviso directamente en los archivos. Esta decision la tomamos a proposito para ser rapidos; iteraciones van despues.
Reglas innegociables
Estas son las reglas que definen la calidad de esta skill. Rompelas y la skill pierde su valor:
- Nunca inventes precios, servicios ni condiciones. Si la transcripcion no lo cubre, pregunta.
- Siempre 2 opciones de pricing (fee unico + fee inicial con mensualidad). No una, no tres.
- IVA siempre separado, nunca incluido en el precio principal. Formato:
X EUR + IVA (21%) = Y EUR total. - Idioma = idioma de la reunion. No traduzcas.
- Pregunta en una ronda agrupada cuando puedas, no marees con 8 mensajes separados.
- Fuera de alcance: sugieres proactivamente. Es el punto que mas te diferencia de un redactor automatico.
- Tono: formal-corporativo con toque cercano-consultor. Ni distante ni desenfadado.
- No introduzcas claims o cifras que el usuario no haya validado (ej: "+40% de conversion" solo si el usuario lo aporta).
Estructura de archivos de la skill
~/.claude/skills/comercial/
├── SKILL.md (este archivo)
├── config.json.example (plantilla, el usuario copia a config.json)
├── README.md (instrucciones de instalacion)
├── templates/
│ ├── propuesta.html (template HTML con placeholders)
│ └── propuesta-docx-spec.md (spec para la skill docx)
├── scripts/
│ └── fathom-client.mjs (cliente API Fathom)
└── examples/
└── ejemplo-propuesta.html (propuesta ejemplo para referencia visual)
Si algo falla
- Fathom API devuelve error o 401: cae al modo manual y pide transcripcion pegada.
- Config.json no existe: guia al usuario a copiar el
.exampley rellenar los campos minimos (empresa, firmante, colores). - Skill docx no disponible: genera solo el HTML y avisa: "DOCX no generado porque la skill
anthropic-skills:docxno esta disponible. Solo HTML." - Transcripcion muy corta o sin info comercial (ej: reunion interna, no con cliente): informa al usuario y para. No generes propuesta con contenido inventado.
Cuando NO usar esta skill
- Reunion interna (no con cliente/lead) → para, no generes nada.
- Usuario quiere un contrato o acuerdo legal → esta skill hace propuestas comerciales, no contratos. Sugiere usar otra herramienta.
- Usuario quiere cotizacion rapida sin reunion previa → esta skill necesita transcripcion. Si no hay reunion, pregunta si quiere pegarnos briefing escrito equivalente.