# Claude Skill Comercial

> Comercial — Generador de propuestas desde transcripcion de reunion

- Skill: `angelapaia/claude-skill-comercial` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx get-skill add angelapaia/claude-skill-comercial`
- Raw SKILL.md: https://api.skillmd.com/api/skills/angelapaia/claude-skill-comercial/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: angelapaia (https://skillmd.com/u/angelapaia)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/angelapaia/claude-skill-comercial

---


# 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:

```bash
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):

1. **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)

2. **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."

3. **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.)"

4. **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?"

5. **Timeline y equipo** (solo si no quedaron claros en la reunion).

6. **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**:

1. **Portada** — logo + cliente + titulo proyecto + fecha + firmante
2. **Resumen ejecutivo** — 3-4 lineas: que problema resolvemos, como, inversion indicativa
3. **Contexto y diagnostico** — lo que el cliente describio como situacion actual, con detalles que demuestren escucha
4. **Objetivos del proyecto** — medibles cuando sea posible
5. **Alcance / Que incluye** — entregables concretos, en bullets o tarjetas
6. **Fuera de alcance** — lo que NO incluye (critico para evitar scope creep)
7. **Metodologia / Como trabajamos** — fases, proceso, hitos
8. **Timeline** — fechas o duraciones, hitos clave visualizados
9. **Equipo** — quien trabaja en esto
10. **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")
11. **Condiciones** — validez de la oferta, forma de pago, propiedad intelectual
12. **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 print` CSS 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:docx` pasandole la especificacion en `templates/propuesta-docx-spec.md` rellena 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-DD` asegura orden alfabetico cronologico.
- Sufijo `_v1` permite 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 `.example` y 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:docx` no 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.

