> ## Documentation Index > Fetch the complete documentation index at: https://docs.famulor.io/llms.txt > Use this file to discover all available pages before exploring further. # Famulor Skill > Instala el skill de código abierto para prompts de voz, WhatsApp, chat web, correo y flujos de trabajo **Famulor Skill** enseña a tu cliente de IA a diseñar asistentes y trabajar con Famulor. Incluye plantillas de prompts, orientación por canal, escenarios de prueba y referencias para la API pública, MCP, la CLI y el SDK de TypeScript. [Ver el repositorio](https://github.com/bekservice/Famulor-Skill) · [Descargar la última versión](https://github.com/bekservice/Famulor-Skill/releases/latest) · [Guía detallada de instalación](https://github.com/bekservice/Famulor-Skill/blob/main/docs/installation.md) > [!NOTE] > > El **skill aporta instrucciones**. Una **conexión MCP permite acceder al espacio con autorización**. Instalar el skill no conecta tu cuenta automáticamente ni amplía los permisos de una conexión existente. Puedes redactar prompts sin conexión; para leer o cambiar datos del espacio necesitas una. ## Elige por dónde empezar | Quieres… | Empieza por | | - | - | | Crear un asistente de recepción por voz o de reservas | [Diseño de asistentes y plantillas de voz](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/assistant-design.md) | | Adaptar un asistente a WhatsApp, chat web o correo | [Guía de canales y ejemplos de prompts](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/messaging-and-channels.md) | | Mejorar la calidad de las conversaciones | [Pruebas y evaluación](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/testing-and-evaluation.md) | | Encontrar un endpoint, comando CLI o método SDK | [Guía de API y SDK](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/api-and-sdk.md) | | Preparar campañas, conocimiento o automatizaciones | [Ejemplos de flujos](https://github.com/bekservice/Famulor-Skill/blob/main/docs/use-cases.md) y [casos de uso de MCP](/es/mcp/use-cases) | ## Aprende con ejemplos completos La [biblioteca de ejemplos](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/README.md) muestra diseños completos de asistentes inspirados en las [demos públicas de Famulor](https://app.famulor.io/demo). | Ejemplo | Qué enseña | | - | - | | [Recepción de hotel](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/hotel-front-desk.md) | Saludo, conocimiento del hotel, disponibilidad real, confirmación y gestión de errores | | [Servicio desde el coche](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/drive-thru.md) | Corregir el carrito, comprobar el presupuesto y enviar el pedido una sola vez | | [Soporte de pedidos](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/order-support.md) | Reglas comunes con adaptaciones para voz, WhatsApp, chat web y correo electrónico | | [Calificación de clientes potenciales](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/lead-qualification.md) | Preguntas útiles, próximos pasos adecuados y respeto a la negativa de contacto | Cada ejemplo incluye un briefing completo, el prompt final, la ubicación de cada ajuste, las herramientas necesarias durante la conversación, un diálogo ilustrativo y criterios de aceptación. El [modelo de entrega](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/assistant-deliverable.md) muestra cómo presentar la propuesta final y su estado de verificación. Las empresas y los resultados de ejemplo son ficticios: una conversación simulada de la demo no demuestra una reserva o un pedido real. Conecta las herramientas reales y verifica sus resultados antes de afirmarlo a los clientes. Los ejemplos completos del repositorio están en inglés. ## Instalación Para agentes de código compatibles con Agent Skills: ```bash theme={null} npx skills add bekservice/Famulor-Skill --skill famulor-skill ``` Elige tu cliente en el instalador. Por defecto se instala en el proyecto actual; añade `-g` para una instalación global. Revisa el paquete antes de instalarlo. Para actuar en tu espacio, añade una conexión MCP remota **Streamable HTTP** y autentícate mediante OAuth: ```text theme={null} https://app.famulor.io/mcp ``` En un espacio de marca blanca, usa el dominio indicado en **Settings → API & MCP**. Tu plan debe incluir **Connect AI / MCP**, y tu rol y permisos aprobados deben permitir la acción. Una URL específica como `https://app.famulor.io/mcp?toolsets=assistants,calls` reduce las herramientas disponibles sin conceder permisos adicionales. **Claude Code** Instala el plugin completo desde el marketplace del repositorio: ```text theme={null} /plugin marketplace add bekservice/Famulor-Skill /plugin install famulor@famulor ``` Abre `/mcp` y autentica Famulor. El paquete incluye el skill y la configuración MCP. Si instalaste solo el skill con `npx skills`, añade la conexión por separado: ```bash theme={null} claude mcp add --transport http famulor https://app.famulor.io/mcp ``` **Claude web y escritorio** 1. Descarga **`famulor-skill.zip`** desde la [última versión](https://github.com/bekservice/Famulor-Skill/releases/latest). 2. Abre **Customize → Skills → + → Create skill → Upload a skill** y sube ese ZIP. No subas el ZIP de todo el repositorio. 3. Activa el skill. Tu cuenta u organización debe permitir skills y ejecución de código. 4. Conecta Famulor en **Customize → Connectors**. Usa un conector personalizado con la URL MCP para las herramientas que necesites. 5. Inicia una conversación nueva y pide a Claude que use Famulor Skill. El [conector de directorio Famulor Assistants & History](https://claude.ai/directory/famulor-assistants-history) ofrece acceso de solo lectura. No puede guardar prompts ni enviar mensajes. Si tu interfaz es distinta, consulta la [guía de Claude para subir skills](https://support.claude.com/en/articles/12512180-use-skills-in-claude). **ChatGPT** Instala el [plugin oficial de Famulor](https://chatgpt.com/plugins/plugin_asdk_app_6a8a46791ed08191a79aa4c98f34d772), conecta tu cuenta y selecciona **@Famulor** en una conversación. Este listado ofrece **11 herramientas de solo lectura** para revisar asistentes e historial. Para un dominio personalizado o herramientas autorizadas adicionales, abre **ChatGPT Plugins → + → Add custom MCP server** en la web. Introduce la URL MCP, elige **OAuth**, revisa la conexión y créala como plugin. Inicia sesión, selecciona tu espacio y aprueba el acceso necesario. Instala el plugin creado y selecciónalo con **@**. Una instalación local del skill no configura ChatGPT web. El plugin oficial tampoco incluye automáticamente esta versión del skill de GitHub. Para redactar prompts, proporciona la plantilla relevante y los requisitos de tu negocio en la conversación. Las reglas de la cuenta u organización pueden limitar las conexiones personalizadas; consulta la [guía MCP actual de OpenAI](https://developers.openai.com/api/docs/guides/custom-mcp-server). **Codex** Después de instalar el skill, configura y verifica MCP: ```bash theme={null} codex mcp add famulor --url https://app.famulor.io/mcp codex mcp login famulor codex mcp get famulor ``` Reinicia la sesión y pide a Codex que use `$famulor-skill`. En los clientes IDE también puedes añadir la conexión en **MCP servers → Add server → Streamable HTTP**. **Cursor** Elige Cursor en el instalador del skill. Añade la URL remota en los ajustes MCP de Cursor o usa esta configuración de proyecto en `.cursor/mcp.json`: ```json theme={null} { "mcpServers": { "famulor": { "url": "https://app.famulor.io/mcp" } } } ``` Autentícate cuando se solicite y verifica que las herramientas de Famulor estén activadas. **Gemini CLI** Instala la extensión, que incluye el skill y la configuración MCP: ```bash theme={null} gemini extensions install https://github.com/bekservice/Famulor-Skill ``` Revisa las capacidades solicitadas. Ejecuta `/mcp auth famulor` si se requiere autenticación y después `/extensions list` para comprobar la instalación. Para otros clientes compatibles, usa el instalador o copia la carpeta completa `skills/famulor-skill/`, incluidas sus referencias, scripts y plantillas. Copiar solo `SKILL.md` deja fuera las guías de apoyo. La versión publicada también ofrece `famulor.skill` para importadores compatibles. ## Verifica con una solicitud de solo lectura > Usa Famulor para listar mis asistentes. Indica qué espacio está conectado. No cambies nada. Después prueba una revisión concreta: > Usa Famulor Skill para revisar mi asistente de soporte para el chat de texto del sitio web. Propón un prompt mejorado y tres conversaciones de prueba. No guardes ni envíes nada. Un paquete descargado o una autorización OAuth completada no demuestra que una herramienta haya funcionado. Confirma que el cliente devuelve datos reales del espacio correcto. Una conexión de solo lectura permite revisiones y borradores; guardar cambios requiere los permisos de escritura correspondientes. ## Prompts adecuados para cada canal Mantén las políticas del negocio, las fuentes fiables y las reglas de acción en el prompt de sistema compartido. Usa **Additional channel instructions** para tono, longitud y formato cuando tu plan incluya respuestas manuales por canal. * **Voz:** turnos hablados breves, una pregunta clara, un saludo adecuado y herramientas reales de transferencia o reserva. * **WhatsApp:** mensajes compactos, intervención humana, la ventana de servicio vigente y plantillas aprobadas para los contactos autorizados que las requieran. * **Chat web:** enlaces legibles, contexto del formulario previo, respuestas escritas útiles y una prueba del widget real. * **Correo:** cuerpo completo, hilo y firma correctos, y una distinción clara entre borrador y respuesta enviada. Un prompt no puede conectar un calendario, crear una herramienta, conceder permisos ni demostrar una entrega. El skill guía al cliente para inspeccionar la configuración, resolver identificadores reales, usar acciones compatibles y verificar el resultado. Empieza por las [solicitudes de ejemplo](https://github.com/bekservice/Famulor-Skill/blob/main/docs/use-cases.md) y prueba el canal que utilizarán tus clientes. ## Actualizaciones y solución de problemas Para un skill gestionado por el instalador, ejecuta `npx skills check` y luego `npx skills update`. Si lo subiste manualmente a Claude, carga el ZIP de la última versión. La autorización MCP sigue siendo independiente; eliminar archivos locales no revoca necesariamente el acceso OAuth. | Síntoma | Siguiente paso | | - | - | | Skill instalado, pero sin herramientas | Añade la conexión MCP, autentícate y reinicia la sesión del cliente. | | Solo 11 herramientas de lectura | Usas el perfil del directorio. Necesitas una conexión personalizada autorizada por separado para más acciones. | | No puedes guardar un asistente | Comprueba el espacio, el rol, los permisos aprobados y el plan. | | Una escritura agotó el tiempo | Lee el estado actual antes de reintentarlo; la primera acción puede haber terminado. | | Los controles de instalación son distintos | Sigue la [guía de instalación mantenida](https://github.com/bekservice/Famulor-Skill/blob/main/docs/installation.md) y la documentación oficial del cliente. | Usa las [issues del repositorio](https://github.com/bekservice/Famulor-Skill/issues) para problemas reproducibles del skill o la documentación. Elimina datos de clientes y credenciales de los ejemplos. Para consultas de tu cuenta, contacta con [soporte de Famulor](/es/support). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.