Claude Code

Usa Claude Code para convertir la petición de un cliente en una comprobación de disponibilidad y una reserva en VillaSlot. Con el skill instalado, Claude puede consultar tus villas, tus clientes, tus tarifas y tus horarios de apertura a través de la API.

Instalar el skill para Claude Code

En tu espacio de trabajo de Claude Code, ejecuta:

bash
npx skills add https://github.com/mikecodeur/skills --skill villaslot

Elige Claude Code cuando el instalador lo pida. También puedes indicarlo explícitamente:

bash
npx skills add https://github.com/mikecodeur/skills --skill villaslot --agent claude-code

Abre una nueva sesión de Claude Code después de la instalación para que el skill esté disponible en la sesión. Pide a Claude que use el skill villaslot para las operaciones de reserva.

Conectar tu organización

En VillaSlot, abre Cuenta → Claves API y genera una clave para la organización de destino. Pon el secreto a disposición como VILLASLOT_API_KEY en el entorno que lanza Claude Code.

Define la dirección del servicio:

bash
export VILLASLOT_BASE_URL="https://www.villaslot.io"

No pegues el secreto en un artículo, un repositorio ni una conversación compartida. Una clave lleva los permisos de quien la creó; instalar el skill no eleva esos permisos.

Comprobar la conexión

Use the villaslot skill and VILLASLOT_API_KEY from the environment.
Read /api/v1/me, tell me the organization name and timezone, then list
its active villas and their hourly rates. Do not make changes.

Comprueba que la organización devuelta es la que quieres gestionar.

Encontrar una franja para un cliente

Da a Claude una fecha local y una duración precisas:

Use VillaSlot to find a two-hour shooting slot at Villa Pasir on
2026-10-15 after 10:00 in the organization's timezone.
Show me the available times and the price before creating a booking.

Una vez elegida la franja, puedes pedir a Claude que encuentre la ficha del cliente y cree la reserva. Indica si debe ser provisional (HOLD) o confirmada. Una reserva provisional puede bloquear una franja y consumir la cuota de tu plan: es una operación de reserva real.

Claude debe usar el identificador de reserva devuelto para los cambios posteriores. La disponibilidad se vuelve a comprobar al crear la reserva; una franja ofrecida antes puede haberse ocupado entretanto.

Modificar un anuncio de villa

Un propietario o administrador de la organización puede pedir:

Rename my villa “Studio Garden” to “Garden Villa”. Keep its opening
hours and rates unchanged, and show me the updated listing.

También puedes subir fotos y reemplazar el horario de apertura o las tarifas por hora. Indica el horario completo que quieres, o pide a Claude que lea y conserve primero las entradas existentes. Un archivado o una cancelación debe corresponder a tu petición explícita y a su objetivo.

Solución de problemas

  • Skill no encontrado: comprueba el alcance de la instalación y abre una nueva sesión en el espacio de trabajo donde se instaló.
  • 401: comprueba la clave de VillaSlot, su organización y si ha sido revocada.
  • 403 o 404: comprueba los permisos de quien creó la clave, y que el recurso pertenece a la misma organización.
  • 409: pide a Claude que explique el conflicto o el límite del plan antes de intentar otra operación.

Consulta Agentes, la referencia de la API y la documentación de los skills de Claude Code.