CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cqrs-implementation

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

55

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/backend-development/skills/cqrs-implementation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

43%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill is well-structured with exemplary progressive disclosure, but the body itself is conceptual rather than instructional: no code, commands, or sequenced workflow appear inline, and portions restate CQRS fundamentals Claude already knows. Most of the executable value lives one reference away.

Suggestions

Replace the ASCII architecture diagram and component glossary with a short inline worked example (or move them into references/details.md) to stop re-teaching CQRS fundamentals Claude already knows.

Add a concise numbered implementation sequence in the body (e.g., define commands -> write handlers -> publish events -> project read model -> verify read model) so the workflow is ordered rather than purely conceptual.

Pull one small copy-paste-ready snippet (e.g., a minimal command-bus or projector skeleton) into the body so the overview itself gives executable guidance before deferring to references/details.md.

DimensionReasoningScore

Conciseness

The body is mostly efficient, but the 24-line ASCII architecture diagram and the key-components glossary table ('Command: Intent to change state') restate textbook CQRS concepts Claude already knows, fitting anchor 3's 'some unnecessary explanation that could be tightened' rather than anchor 4's merely minor over-explanation.

3 / 5

Actionability

The body contains no executable code, commands, or concrete steps — the best-practice bullets ('Denormalize read models', 'Version your events') are high-level directives, with all concrete templates delegated to references/details.md. This matches anchor 2 ('minimal concrete guidance; high-level hints but missing specific steps'), not anchor 1, since the reference pointer and component table give some concrete grounding.

2 / 5

Workflow Clarity

There is a rough conceptual progression (architecture, components, templates, practices) but no sequenced implementation workflow and no validation checkpoints, matching anchor 2's 'rough sequence present but many gaps' rather than anchor 3's clearly listed steps.

2 / 5

Progressive Disclosure

The 79-line body is a lean overview that clearly signals a single, verified, one-level-deep reference ('Full template library and detailed worked examples live in references/details.md'), with content appropriately split between the overview and the 475-line template file — a direct match for anchor 5.

5 / 5

Total

12

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit 'Use when' clause carrying three natural trigger phrases and a clear, distinct CQRS niche. Its main gaps are the missing 'CQRS' acronym/synonyms in the trigger terms and a single-verb 'what' statement.

Suggestions

Add the acronym 'CQRS' and common synonyms (e.g., 'event sourcing', 'read model / write model') to the trigger clause to broaden natural keyword coverage.

Expand the 'what' with one or two more concrete actions (e.g., 'implement command handlers, project events into denormalized read models') to improve specificity.

DimensionReasoningScore

Specificity

The description names the domain ('Command Query Responsibility Segregation') with one concrete action ('Implement') but offers no additional specific actions, matching the '1-2 concrete actions, not comprehensive' anchor rather than anchor 4's 'several specific actions'.

3 / 5

Completeness

It explicitly answers both 'what' ('Implement Command Query Responsibility Segregation for scalable architectures') and 'when' ('Use when separating read and write models, optimizing query performance, or building event-sourced systems') with concrete trigger phrases, matching anchor 5; anchor 4 would require a weaker or less explicit 'when' clause.

5 / 5

Trigger Term Quality

Natural phrases like 'separating read and write models', 'optimizing query performance', and 'building event-sourced systems' are phrases users would actually say, but the acronym 'CQRS' and common synonyms (e.g. 'event sourcing', 'read/write model') are missing, falling short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

CQRS is a clear niche with distinct triggers, but 'building event-sourced systems' could overlap with a dedicated event-sourcing skill, giving minor overlap risk consistent with anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

wshobson/agents

Path

plugins/backend-development/skills/cqrs-implementation/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.