Claude Code

Utilisez Claude Code pour transformer une demande client en vérification de disponibilité et en réservation VillaSlot. Une fois le skill installé, Claude peut consulter vos villas, vos clients, vos tarifs et vos horaires d’ouverture via l’API.

Installer le skill pour Claude Code

Dans votre espace de travail Claude Code, lancez :

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

Choisissez Claude Code quand l’installateur le demande. Vous pouvez aussi le cibler explicitement :

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

Ouvrez une nouvelle session Claude Code après l’installation pour que le skill soit disponible dans la session. Demandez à Claude d’utiliser le skill villaslot pour les opérations de réservation.

Connecter votre organisation

Dans VillaSlot, ouvrez Compte → Clés API et générez une clé pour l’organisation cible. Rendez le secret disponible sous le nom VILLASLOT_API_KEY dans l’environnement qui lance Claude Code.

Définissez l’adresse du service :

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

Ne collez pas le secret dans un article, un dépôt ou une conversation partagée. Une clé porte les permissions de la personne qui l’a créée ; installer le skill n’élève pas ces permissions.

Vérifier la connexion

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.

Vérifiez que l’organisation renvoyée est bien celle que vous voulez gérer.

Trouver un créneau pour un client

Donnez à Claude une date locale et une durée précises :

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.

Une fois le créneau choisi, vous pouvez demander à Claude de retrouver la fiche du client et de créer la réservation. Précisez si elle doit être provisoire (HOLD) ou confirmée. Une option peut bloquer un créneau et consommer le quota de votre offre : c’est une vraie opération de réservation.

Claude doit utiliser l’identifiant de réservation renvoyé pour les modifications suivantes. La disponibilité est vérifiée à nouveau au moment de créer la réservation ; un créneau proposé plus tôt a pu être pris entre-temps.

Modifier une annonce de villa

Un propriétaire ou un administrateur de l’organisation peut demander :

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

Vous pouvez aussi téléverser des photos et remplacer les horaires d’ouverture ou les tarifs horaires. Indiquez le planning complet voulu, ou demandez à Claude de lire et de conserver d’abord les entrées existantes. Un archivage ou une annulation doit correspondre à votre demande explicite et à sa cible.

Dépannage

  • Skill introuvable : vérifiez la portée de l’installation et ouvrez une nouvelle session dans l’espace de travail où il a été installé.
  • 401 : vérifiez la clé VillaSlot, son organisation et si elle a été révoquée.
  • 403 ou 404 : vérifiez les permissions de la personne qui a créé la clé, et que la ressource appartient bien à la même organisation.
  • 409 : demandez à Claude d’expliquer le conflit ou la limite de l’offre avant de tenter une autre opération.

Voir Agents, la référence de l’API, et la documentation des skills de Claude Code.