Available Skills¶
When you install the Claude Code Plugin, you get a set of Skills that map to EventSourcingDB operations. Each Skill can be invoked explicitly by name, or Claude can select the right one automatically based on what you describe in natural language. This page describes each Skill from an application perspective, explaining what it does and when it is useful.
Health and Authentication¶
/esdb:ping checks whether the connection to EventSourcingDB is healthy. Use this Skill to verify that Claude can reach your database before attempting any other operation. No authentication is required for this Skill.
/esdb:verify-api-token verifies that your API token is valid for the EventSourcingDB instance. This is useful for confirming that authentication is set up correctly before performing operations that require authorization.
Writing Events¶
/esdb:write-events stores one or more events in EventSourcingDB. Each event must include a source, subject, type, and data payload. Optional preconditions can be specified to ensure write consistency, such as requiring that a subject is pristine, checking for optimistic locking, or evaluating a custom EventQL condition. Use this Skill when you want to record new events, such as acquiring a book or registering a reader.
Reading Events¶
/esdb:read-events retrieves events from EventSourcingDB for a given subject. It supports filtering by event ID bounds, ordering, recursive reading from sub-subjects, and resuming from a specific event. Use this Skill to inspect the event history of a particular entity or to review individual events.
/esdb:observe-events opens a real-time streaming connection and shows events as they are written. This is useful for monitoring during development, verifying that your write path works, or demonstrating event flow. The connection automatically closes after a timeout (default: 30 seconds).
Subjects and Event Types¶
/esdb:read-subjects lists all subjects under a given base subject. This helps you discover what entities exist in the event store, for example all books or all readers in a library system.
/esdb:read-event-types returns all event types that have been stored, along with any schemas that have been registered for them. Use this Skill to understand the structure of the data in your event store.
/esdb:read-event-type retrieves the details and JSON Schema for a specific event type. While /esdb:read-event-types gives a broad overview, this Skill is useful when you need the detailed schema for one particular event type.
Querying¶
/esdb:run-eventql-query executes an EventQL query against the event store and returns the results. EventQL supports filtering, grouping, aggregation, ordering, and projecting events. Use this Skill when you have analytical questions that span multiple subjects or require aggregation, such as counting how many books a reader has borrowed or finding the most active readers.
Schemas¶
/esdb:register-event-schema associates a JSON Schema with a specific event type. Once a schema is registered, EventSourcingDB validates incoming events of that type against the schema. Use this Skill when you want to enforce a particular structure for your events. Note that schemas are immutable once registered.