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

The canonical home for this skill is cqrs-implementation in rmyndharis/antigravity-skills

SKILL.md
Quality
Evals
Security

Quality

Content

57%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 excellently concise and well-organized with appropriate use/anti-use trigger sections, but the actual guidance is a thin checklist of abstract directives whose only source of concrete detail — the implementation playbook — is a broken reference that does not exist in the bundle.

Suggestions

Add concrete, actionable substance to the Instructions (or a real playbook file): specific steps or patterns for defining command/query boundaries, a concrete approach to read-model projection and synchronization, and a concrete validation method with failure-recovery guidance.

Fix the progressive-disclosure gap: either create `resources/implementation-playbook.md` (or move it to the conventional `references/` directory and update both mentions), or inline the essential patterns so the skill is self-sufficient.

Tighten workflow clarity by making the final 'Validate' step an explicit checkpoint with pass/fail criteria and a fix-and-retry loop (e.g., what to check in performance, recovery, and failure-mode testing and what to do when it fails).

DimensionReasoningScore

Conciseness

The ~30-line body is lean and assumes Claude's competence: no explanation of what CQRS is, no library comparisons, no padding. The one-line intro ("Comprehensive guide to implementing..."), the only near-redundant token, mirrors the good examples' economy and keeps it at anchor 5 ('every token earns its place').

5 / 5

Actionability

The Instructions are high-level hints with no specific executable guidance: "Define command and query models with clear boundaries", "Implement read model projections and synchronization", "Validate performance, recovery, and failure modes" name activities but give no concrete method, commands, examples, or decision criteria. This matches anchor 2 ('high-level hints but missing the specific steps to execute') — it never reaches anchor 3's 'some concrete guidance', and the deferred detail file does not exist to rescue it.

2 / 5

Workflow Clarity

The four Instructions form a coherent sequence (identify → define → implement → validate), but the validation step ("Validate performance, recovery, and failure modes") has no checkpoint, method, or failure-recovery loop. This is anchor 3: 'sequence present but checkpoints missing or implicit'.

3 / 5

Progressive Disclosure

The structure is good on paper — clear 'Use/Do not use' sections and a single one-level-deep reference clearly signaled in a Resources section — but the referenced path `resources/implementation-playbook.md` does not exist in the bundle (no references/, resources/, scripts/, or assets/ directories are present). Scored against the actual bundle structure, the sole detail layer is a dangling pointer, so navigation fails despite the clean shape; this sits between anchor 4's 'references mostly clear' and anchor 2's structural failures.

3 / 5

Total

13

/

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 well-constructed description in third person with an explicit and concrete 'Use when...' clause. Its main weakness is that the 'what' is a single abstract action — implementing CQRS — without naming the concrete sub-capabilities the skill actually provides.

DimensionReasoningScore

Specificity

The description names the domain ("Command Query Responsibility Segregation", "read and write models", "event-sourced systems") and one concrete action ("Implement"), but stops there — it never mentions the actual sub-tasks involved (defining commands/queries, building projections, synchronizing read models). This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) better than anchor 4's 'several specific actions', and is above anchor 2's minimal/generic action.

3 / 5

Completeness

It explicitly answers 'what' ("Implement Command Query Responsibility Segregation for scalable architectures") and 'when' with three concrete trigger phrases in a proper 'Use when...' clause, mirroring the anchor-5 example structure. It clearly exceeds anchor 4, whose 'when' is present but less specific.

5 / 5

Trigger Term Quality

"Use when separating read and write models, optimizing query performance, or building event-sourced systems" covers natural phrases users would say, but misses common variations — 'CQRS' itself, 'event sourcing', 'read model'/'write model' as standalone terms, or 'query-side/write-side'. Good coverage with a few natural terms missing fits anchor 4, not the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

CQRS is a fairly clear niche and triggers like "separating read and write models" are distinct, but "optimizing query performance" could overlap with general database-optimization skills and "building event-sourced systems" with a dedicated event-sourcing skill. Minor overlap risk with closely related skills fits anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-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.