PlugWiki

cqrs-implementation Skill for Claude: What It Does and How to Install It

Guides your assistant to design CQRS systems with separate read and write models.

Installs
11.2K
on skills.sh
Stars
42.1K
on GitHub
Files
1
besides SKILL.md
Updated
Oct 2026
last repo commit

SKILL.md defines a CQRS architecture diagram and six components (command, command handler, event, query, query handler, projector), plus do and don't lists such as versioning events and not querying inside commands. Five Python templates sit in references/details.md: command infrastructure, query infrastructure, a FastAPI CQRS application, read model synchronization and eventual consistency handling.

Its "When to Use" list covers separating read and write concerns, scaling reads on their own, event-sourced systems, different read and write data models and high-performance reporting. It bundles no scripts.

Good for

  • Backend engineers splitting read and write paths
  • Teams building event-sourced systems
  • Developers speeding up reporting queries

Install cqrs-implementation

Claude Code

  1. 1

    Copy this prompt.

    Install the cqrs-implementation skill in Claude Code. Run this command:

/plugin marketplace add wshobson/agents
/plugin install backend-development@claude-code-workflows

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The plugin routes install the whole backend-development plugin: 8 agents, 1 command and 9 skills (counted from the plugin folder in the repo tree, which has no hooks or MCP config files). The skills-only routes install just this skill, with no agents or commands. The templates are Python and use FastAPI and Pydantic.

From the project README. Source.

What's in the skill

When it loads

Implement Command Query Responsibility Segregation for scalable architectures. Use when separating read and write models, optimizing query performance, or building event-sourced systems.

Sections in SKILL.md

  1. When to Use This Skill
  2. Core Concepts
  3. 1. CQRS Architecture
  4. 2. Key Components
  5. Templates and detailed worked examples
  6. Best Practices
  7. Do's
  8. Don'ts

Key facts

Author
wshobson (repo owner)
License
MIT
Installs on skills.sh
11,194 (Nov 2, 2026)
GitHub stars
42,081 for the whole wshobson/agents repo (Nov 2, 2026)
Last repo commit
Oct 30, 2026
What it includes
2 files including SKILL.md: references/details.md (no scripts)
Part of
The backend-development plugin (version 1.3.3) in wshobson/agents. Counted from the plugin folder: 8 agents, 1 command and 9 skills
Works in
Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot and Pi, per the README. Skills-only installers ask which tool you use

What it includes

  • Clients to a commands API and a queries API, with events feeding the read model

    Clients to a commands API and a queries API, with events feeding the read model.

    CQRS architecture diagram

  • Command, command handler, event, query, query handler and projector

    Command, command handler, event, query, query handler and projector.

    Key components table

  • Do and don't lists, such as versioning events and defining acceptable consistency lag

    Do and don't lists, such as versioning events and defining acceptable consistency lag.

    Best practices

  • Command base, command bus and a command handler

    Command base, command bus and a command handler (in references/details.md)

    Template 1: Command infrastructure

  • Query base, result types, query bus and a query handler

    Query base, result types, query bus and a query handler (in references/details.md)

    Template 2: Query infrastructure

  • Command endpoints (POST, PUT, DELETE) and query endpoints (GET)

    Command endpoints (POST, PUT, DELETE) and query endpoints (GET) (in references/details.md)

    Template 3: FastAPI CQRS application

  • A synchronizer with checkpoints and a rebuild-from-scratch method for a projection

    A synchronizer with checkpoints and a rebuild-from-scratch method for a projection (in references/details.md)

    Template 4: Read model synchronization

  • A query handler that waits for the read model to reach an expected version

    A query handler that waits for the read model to reach an expected version, then returns a stale-data warning on timeout (in references/details.md)

    Template 5: Eventual consistency handling

From the official docs

Questions

What does the cqrs-implementation skill do?

It gives the assistant a CQRS design guide and five Python templates. Use it to split a service into command and query sides, build projectors and handle the lag between the write and read models.

How do I install cqrs-implementation?

Use the install box at the top of this page. For Claude Code it lists the plugin route (/plugin marketplace add wshobson/agents, then /plugin install backend-development@claude-code-workflows) and two skills-only commands: npx skills add wshobson/agents --skill cqrs-implementation and gh skill install wshobson/agents cqrs-implementation (GitHub CLI 2.90 or later), which skip the plugin's agents and commands.

Is CQRS the same as event sourcing?

Not exactly. SKILL.md lists event-sourced systems as one use case, and its component table includes events and a projector that updates the read model from them. CQRS as defined there is the split into separate read and write models.

Is it safe?

Its folder holds two Markdown files and no scripts. The templates are Python sample code: Template 4 includes a method that clears a projection and replays events, and Template 5 runs a SQL query against a projection_state table. Review generated code before you run it against a real database.

Should I install the whole backend-development plugin?

Only if you want the rest. The README documents a plugin route for Claude Code and Codex. The backend-development plugin folder holds 8 agents, 1 command and 9 skills, and its repo tree shows no hooks or MCP config files. The install box offers the plugin and the skills-only commands.

Does it work in Codex or Cursor?

The README documents Codex CLI as a plugin route and a skills-only install. For Cursor it points to a plugin marketplace and its setup docs, which we did not check, so follow the README there.

Is this skill from Anthropic?

No. It is in wshobson/agents, a community collection. The skill sits in the backend-development plugin there, alongside api-design-principles, architecture-patterns, event-store-design, microservices-patterns, projection-patterns, saga-orchestration, temporal-python-testing and workflow-orchestration-patterns.

Information

updated Nov 2, 2026

Repository
wshobson/agents
Folder
plugins/backend-development/skills/cqrs-implementation

wshobson/agentsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5
  1. cqrs-implementation SKILL.md · github.com
  2. wshobson/agents README · github.com
  3. backend-development plugin.json · github.com
  4. wshobson/agents marketplace.json · github.com
  5. details.md · github.com

Updated Nov 2, 2026.