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.

Quality

73%

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 ./skills/cqrs-implementation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 body is lean and well-organized, with useful use/don't-use scoping sections and a logical high-level instruction sequence. However, it provides no concrete, executable guidance — no examples, commands, or named patterns — and defers all detail to a playbook file that is absent from the bundle, leaving the skill as directives a competent model could produce unaided.

Suggestions

Add concrete, executable guidance to the Instructions section — e.g., a sample command/query model split, a read-model projection snippet, or a named synchronization approach (CDC, event subscriptions, scheduled rebuilds) — so the skill delivers value even without the playbook.

Ship the referenced "resources/implementation-playbook.md" (or fix the path): the skill's only source of detail currently points to a file that does not exist in the bundle, breaking its progressive-disclosure structure.

Turn "Validate performance, recovery, and failure modes" into explicit checkpoints with a feedback loop — specify what to verify after implementing projections (projection lag, read-model completeness, recovery behavior) and what to do when a check fails.

DimensionReasoningScore

Conciseness

The body is ~37 lines, lean, and assumes Claude already knows CQRS. Minor trims remain: "Comprehensive guide to implementing CQRS (Command Query Responsibility Segregation) patterns" duplicates the frontmatter description (including re-expanding the acronym), and the "Use this skill when" bullets largely restate the description's triggers. This is anchor 4 ("minor instances of over-explanation that could be trimmed"), not 5, since those tokens do not earn their place.

4 / 5

Actionability

The Instructions are high-level directives with no specifics: "Implement read model projections and synchronization" and "Define command and query models with clear boundaries" name artifacts but give no code, commands, examples, or named techniques. All concrete detail is deferred to "resources/implementation-playbook.md", which does not exist in the bundle, leaving no executable substance — anchor 2 ("high-level hints but missing the specific steps to execute"). It does not reach 3 because no step includes even partial concrete guidance.

2 / 5

Workflow Clarity

A rough sequence is present (identify workloads, define models, implement projections, validate) and a validation step is named ("Validate performance, recovery, and failure modes"), but there are no checkpoints and no feedback loop — nothing on what to verify or what to do when validation fails. This matches anchor 3 ("sequence present but checkpoints missing or implicit"); the steps are too well-ordered for 2 and too unspecified for 4.

3 / 5

Progressive Disclosure

The written structure is sound — a concise overview with one clearly-signaled, one-level-deep reference ("If detailed patterns are required, open `resources/implementation-playbook.md`" plus a Resources section). But scored against the actual bundle, no bundle files exist and the single referenced path is dangling, so the skill's only source of depth resolves to nothing. This organizational failure caps it at anchor 3 rather than 4.

3 / 5

Total

12

/

20

Passed

Description

83%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 that clearly answers both what the skill does and when to use it, with concrete, natural trigger phrases covering the main CQRS use cases. Trigger coverage is good but lacks common synonyms (e.g., "event sourcing" as a noun, "projections"), and the broad "optimizing query performance" trigger invites minor overlap with general performance-tuning skills.

DimensionReasoningScore

Specificity

Quotes: "Implement Command Query Responsibility Segregation", "separating read and write models", "optimizing query performance", "building event-sourced systems" — several specific activities are named with only minor gaps. It falls short of 5 because capabilities like projections, read/write synchronization, and messaging are unmentioned, and above 3 because more than 1-2 concrete actions are listed.

4 / 5

Completeness

"Implement Command Query Responsibility Segregation for scalable architectures" explicitly states the what, and "Use when separating read and write models, optimizing query performance, or building event-sourced systems" explicitly states the when with concrete trigger phrases — matching the anchor-5 example structure. A 4 would require the when to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural phrases like "read and write models", "query performance", and "event-sourced systems" match what users in this domain would say. Not 5 because common synonyms and variations are missing ("event sourcing" as a noun, "projections", "read model"/"write model", "command side"/"query side").

4 / 5

Distinctiveness Conflict Risk

CQRS is a clear niche with distinct triggers, but "optimizing query performance" is broad enough to overlap general performance-tuning or database-indexing skills, and "event-sourced systems" could collide with a dedicated event-sourcing skill. Minor overlap risk with closely related skills fits anchor 4; the niche is too specific for 3.

4 / 5

Total

17

/

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

rmyndharis/antigravity-skills

Path

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.