Kurrent Agent Skills

A plugin marketplace that gives AI coding assistants (Claude Code, Cursor, Codex, and other agent platforms) first-class knowledge of Kurrent and its ecosystem.

Each plugin ships focused references that the agent loads on demand, so it can answer your questions and write your code with accurate, up-to-date context instead of guessing.

What's Included

The repository ships one plugin (kurrent) containing five skills and three agents covering everyday SDK and server use, client configuration, migration, code review, and runtime diagnosis.

Skills

Skill	What it covers
kurrent-docs	The everyday router for SDK and server work. Covers the six client SDKs, the self-hosted KurrentDB server, Kurrent Cloud, and the esc CLI. Start here.
kurrentdb-connection	Opinionated guidance for configuring the gRPC client across all six SDKs. Covers connection strings, node discovery, keepalive, deadlines, serverless reuse, and connection failure triage.
kurrentdb-client-detection	Inventories the client surface in an application codebase. Finds which SDK, which connection scheme, and which call sites need rewriting.
kurrentdb-server-detection	Inventories a deployed server. Finds the version, cluster topology, license status, and deployment method.
kurrent-upgrade	Onboarding onto the gRPC client. Covers porting an app off the legacy TCP client and rebranding the EventStoreDB gRPC client to KurrentDB across six languages.

Agents

Three agents cover the KurrentDB application lifecycle: migration, review, and runtime diagnosis.

Agent	What it covers
migration-specialist	Orchestrates a client migration. Detects the current client and connection scheme, routes to the right upgrade flavour, and walks through it step by step.
code-reviewer	Reviews application code that uses the client SDKs. Covers idiomatic usage and anti-patterns, with a post-migration mode that audits the legacy surface and runs the build and tests as a gate.
troubleshooter	Diagnoses runtime failures. Covers connection and TLS errors, version conflicts, subscription lag, leader-election and gossip problems, scavenge hangs, and projection divergence.

Behavioural runtime verification belongs to the project's own integration tests. If troubleshooter recommends runtime reproduction, spin up KurrentDB locally with the official Docker recipes documented at https://docs.kurrent.io/.

Installation

Claude Code

Run the following commands from a Claude Code session:

1. Add the marketplace:

   /plugin marketplace add kurrent-io/skills

2. Install the plugin:

   /plugin install kurrent@kurrent-skills

3. Follow the prompts to complete the installation, then run /reload-plugins to activate it.

Cursor

Cursor installs this repo as a team marketplace straight from GitHub (Cursor 2.6+); no public listing required.

1. Open Dashboard > Settings > Plugins.

2. Under Team Marketplaces, click Import, paste the repository URL, and continue:

   https://github.com/kurrent-io/skills
   

3. Review the parsed plugins, then install kurrent. Manage its rules and skills from the Rules section of Cursor Settings.

   Note: On Enterprise plans only admins can add team marketplaces. For a private repo, grant the Cursor GitHub app read access when prompted. For local development, symlink the repo instead: ln -s "$(pwd)" ~/.cursor/plugins/local/kurrent.

Codex

1. Add the kurrent-io/skills marketplace to Codex:

   codex plugin marketplace add kurrent-io/skills

2. Start Codex and open the plugins browser:

   /plugins

3. Navigate to the "Kurrent Skills" tab and install the kurrent plugin.

   Note: Codex's native plugin spec installs the skills but not the agents. Skills that delegate to them will still work, but Codex handles the orchestration inline instead of spawning specialised subagents. Once Codex's plugin spec supports custom agents, this gap goes away.

GitHub Copilot CLI

1. Add the marketplace:

   copilot plugin marketplace add kurrent-io/skills

2. Install the plugin:

   copilot plugin install kurrent

3. Verify it loaded:

   copilot plugin list

   From an interactive session, /plugin list, /agent, and /skills list should show the kurrent plugin.

Skills.sh

Works with Claude Code, Cursor, Cline, opencode, and any other agent the Vercel skills CLI supports. The CLI auto-detects installed agents and links each skill into the right place.

1. List the skills available in this repo:

   npx skills add kurrent-io/skills --list

2. Install everything to every detected agent:

   npx skills add kurrent-io/skills --all

3. Or install the skill into a specific agent — for example, into Claude Code globally:

   npx skills add kurrent-io/skills \
     --skill kurrent-docs \
     -a claude-code -g

   Pass -y for non-interactive installs in CI.

Local install from repository

1. Clone the repository:

   git clone https://github.com/kurrent-io/skills.git

2. Install the skills for your harness:

   Copy the skills/ directory (or individual skills under it) to the location where your coding agent reads its skills or context files. Refer to your agent's documentation for the correct path.

Contributing

See AGENTS.md.

License

See LICENSE for license information.