---
name: fizko-onboarding
description: "Use this skill when the user is setting up a new company, asks about onboarding progress, or needs help completing setup steps. Also use when the user sends documents for onboarding (balance, nomina, previred, constitucion). Triggers on: 'onboarding', 'configurar', 'setup', 'empezar', 'pasos pendientes', 'como empiezo', 'que me falta', 'nomina', 'previred', 'balance ano anterior', 'constitucion'."
mcp-tools:
  - onboarding_progress
  - onboarding_update_step
  - onboarding_collection
  - onboarding_comments
---

# Onboarding

## REGLA PRINCIPAL

NO hagas un resumen del onboarding. NO listes todos los pasos. Ve DIRECTO al primer paso pendiente e intenta completarlo con el usuario AHORA.

## Tools

- `onboarding_progress()` — Pasos del usuario (públicos) con su status
- `onboarding_update_step(step_key, status)` — Actualizar estado de un paso
- `onboarding_collection()` — Documentos requeridos (constitución, liquidaciones, etc)
- `onboarding_comments(step_key)` — Comentarios de un paso

## Pasos que dependen del usuario

### Pasos de información (el usuario responde preguntas)

| Step Key | Pregunta directa |
|----------|-----------------|
| `setup_business_description` | "Contame en una o dos frases: ¿a qué se dedica tu empresa?" |
| `setup_employees` | "¿Cuántos empleados tiene la empresa? Socios: ___ No socios: ___" |
| `setup_operations` | "¿Tienen arriendos, importaciones, exportaciones o créditos bancarios?" |
| `setup_invoicing` | "¿Emiten facturas? ¿Con qué sistema?" |

Cuando el usuario responde:
→ `onboarding_update_step(step_key="...", status="completed")`

### Pasos de documentos (el usuario sube archivos)

| Step Key | Qué pedir | Formatos |
|----------|-----------|----------|
| `payroll_submission` | Nómina de empleados (nombres, RUT, cargo, sueldo bruto) | Excel, PDF |
| `previred_setup` | Credenciales de acceso a Previred | Imagen, PDF |
| `balance_last_year` | Balance 8 columnas del último período contable | Excel, PDF |
| `accounting_documents` | Documentos legales (constitución, liquidaciones, deudas) | PDF |

Para los primeros 3, pide el archivo: "Necesito tu nómina de empleados. ¿Me la puedes enviar?"
El status se completa automáticamente al subir.

Para `accounting_documents`, primero lista qué documentos faltan:
→ `onboarding_collection()`
Luego pide cada documento pendiente al usuario.

## Comportamiento

1. `onboarding_progress()` → identifica el SIGUIENTE paso pendiente
2. Según el tipo:
   - **Información** → haz la pregunta directa → `onboarding_update_step` → siguiente
   - **Documento** → pide el archivo → cuando sube, se completa solo → siguiente
3. Después de completar un paso → pasa INMEDIATAMENTE al siguiente pendiente.

## Notas

- Los pasos que no aplican a la empresa se muestran como `skipped` (ej: nómina si no tiene empleados)
- Ignora pasos con status `skipped`

## Tono

Directo, como un checklist. No expliques de más.
BIEN: "Te faltan 3 pasos. Empecemos: ¿a qué se dedica tu empresa?"
