Claude Code

Use Claude Code to turn a client request into a VillaSlot availability check and booking. With the skill installed, Claude can look up your villas, customers, rates and opening hours through the API.

Install the skill for Claude Code

In your Claude Code workspace, run:

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

Choose Claude Code when prompted. You can also target it explicitly:

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

Start a new Claude Code session after installation so the skill is available to the session. Ask Claude to use the villaslot skill for booking operations.

Connect your organization

In VillaSlot, open Account → API Keys and generate a key for the target organization. Make the secret available as VILLASLOT_API_KEY in the environment used to launch Claude Code.

Set the service address:

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

Do not paste the secret into an article, repository or shared conversation. A key carries its creator's permissions; installing the skill does not elevate those permissions.

Check the connection

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.

Confirm that the returned organization is the one you intend to manage.

Find a slot for a client

Give Claude a precise local date and duration:

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.

After choosing a slot, you can ask Claude to find the customer's record and create the reservation. State whether it should be provisional (HOLD) or confirmed. A hold can block a slot and consume plan quota, so it is a real booking operation.

Claude should use the returned booking ID for later changes. Availability is checked again when the booking is created; a slot offered earlier may have been taken in the meantime.

Update a villa listing

An organization owner or admin can ask:

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

You can also upload photos and replace opening hours or hourly rates. Specify the complete intended schedule or ask Claude to read and preserve existing entries first. Archiving and cancellation should match your explicit request and target.

Troubleshooting

• Skill not found: check the installation scope and start a new session in the workspace where it was installed.
• 401: check the VillaSlot key, its organization and whether it was revoked.
• 403 or 404: check the key creator's permissions and that the resource belongs to the same organization.
• 409: ask Claude to explain the conflict or plan limit before trying a different operation.

See Agents, the API reference, and Claude Code's skill documentation.