laffaire

name	laffaire
description	Use this skill to manage Laffaire calendar projects and entries via its JSON API. Invoke when the user wants to list, create, update, or delete Laffaire events or calendar entries, or asks about their Laffaire instance.
version	1.0.0
allowed-tools	Bash(curl:*)

Laffaire

Manage projects and calendar entries in a Laffaire instance via its JSON API.

In Laffaire, a project is called an Event (a named calendar group), and an individual calendar item within it is called an Entry.

Config

Before making any API call, check whether LAFFAIRE_URL and LAFFAIRE_TOKEN are already set in the environment by running a quick test curl. If a call fails due to missing variables, ask the user to provide them:

• LAFFAIRE_URL — base URL of the Laffaire instance, e.g. https://example.com
• LAFFAIRE_TOKEN — a Bearer token created from the /-/tokens page of the UI

---

Actions

Ask the user what they want to do:

1. List projects — list all their events
2. Create a project — create a new named event/calendar group
3. List entries — list calendar entries in a project
4. Add an entry — add a calendar entry to an existing project
5. Delete a project or entry

---

API Reference

All routes are under /api/v1/. All requests must include:

Authorization: Bearer <token>
Content-Type: application/json

Projects (Events)

List all projects

GET /api/v1/events

Returns an array of { id, title, description }.

Create a project

POST /api/v1/events
{ "title": "My Project", "description": "Optional description" }

Returns 201 with { id, title, description }. The id is needed to add entries.

Get a project

GET /api/v1/events/{id}

Update a project

PUT /api/v1/events/{id}
{ "title": "New Title", "description": "New description" }

Delete a project

DELETE /api/v1/events/{id}

Returns 204 No Content.

---

Entries (Calendar Items)

List entries in a project

GET /api/v1/events/{project_id}/entries

Returns an array of entry objects.

Create an entry

POST /api/v1/entries
{
  "event_id":     "<project id>",
  "subject":      "Team standup",
  "start_date":   "2026-03-10",
  "start_time":   "09:00",
  "end_date":     "2026-03-10",
  "end_time":     "09:30",
  "all_day_event": false,
  "description":  "Daily sync",
  "location":     "Zoom",
  "private":      false
}

event_id and subject are required. Returns 201 with the created entry.

Get an entry

GET /api/v1/entries/{id}

Update an entry

PUT /api/v1/entries/{id}
{ "subject": "...", "start_date": "...", ... }

subject is required.

Delete an entry

DELETE /api/v1/entries/{id}

Returns 204 No Content.

---

Instructions for Claude

• Use curl with $LAFFAIRE_URL and $LAFFAIRE_TOKEN env vars directly — do not hardcode values.
• Always confirm the action with the user before deleting anything.
• When creating an entry, if the user does not supply dates/times, ask before defaulting.
• If the API returns a non-2xx status, show the user the error JSON and suggest next steps.
• After creating a project, offer to immediately add entries to it.

Example curl — list projects

curl -s "$LAFFAIRE_URL/api/v1/events" \
  -H "Authorization: Bearer $LAFFAIRE_TOKEN"

Example curl — create a project

curl -s -X POST "$LAFFAIRE_URL/api/v1/events" \
  -H "Authorization: Bearer $LAFFAIRE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Q2 Roadmap", "description": "Planning items for Q2"}'

Example curl — add an entry

curl -s -X POST "$LAFFAIRE_URL/api/v1/entries" \
  -H "Authorization: Bearer $LAFFAIRE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_id":   "<project id from above>",
    "subject":    "Kickoff meeting",
    "start_date": "2026-03-10",
    "start_time": "10:00",
    "end_date":   "2026-03-10",
    "end_time":   "11:00"
  }'

---

Installation

To install this skill as a slash command:

cp skills/laffaire.md ~/.claude/commands/laffaire.md

Then invoke it with /laffaire in any Claude Code session.