CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

event-sourcing-architect

Expert in event sourcing, CQRS, and event-driven architecture patterns. Masters event store design, projection building, saga orchestration, and eventual consistency patterns. Use PROACTIVELY for event-sourced systems, audit trail requirements, or complex domain modeling with temporal queries.

Quality

78%

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/AI-Agents-Safe-Coding-Skills/skills/event-sourcing-architect/SKILL.md

The canonical home for this skill is event-sourcing-architect in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

65%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 a clean, well-sectioned overview that respects token budget, but it reads more like a capability brochure than an operating manual: instructions are design directives with no concrete examples, schemas, or validation checkpoints. Strengthening actionability and workflow checkpoints would deliver the most improvement.

Suggestions

Add one concrete artifact to anchor the abstract instructions — e.g., a minimal event schema example (event name, aggregate ID, version, correlation ID payload) or a short command-handler snippet showing 'load stream → append event → publish'.

Convert the Instructions into steps with explicit checkpoints: e.g., after building projections, verify the read model against a replayed event stream before wiring queries to it.

Remove duplication to tighten the body: the opening paragraph repeats the frontmatter description verbatim, and event immutability is stated in both Safety and Best Practices.

DimensionReasoningScore

Conciseness

The body is lean bullet-style guidance with no re-explanation of concepts Claude already knows, and it does not pad. It loses a point for redundancy: the opening paragraph repeats the frontmatter description verbatim, and event immutability is stated twice (Safety: "Never mutate or delete committed events" and Best Practices: "Events are facts - never delete or modify them"). Not a 5 due to that duplication; not a 3 because there is no over-explanation or filler.

4 / 5

Actionability

Some concrete anchors exist (correlation IDs for tracing, idempotent event handlers, DBOS for durable process managers, "Rebuild projections in staging"), but the core Instructions are abstract design directives ("Identify aggregate boundaries", "Design events as immutable facts", "Implement command handlers and event application") with no event schema examples, naming conventions, or code. Matches 'some concrete guidance but incomplete'; below 4 because a reader cannot execute most steps without filling in the specifics themselves.

3 / 5

Workflow Clarity

The seven numbered Instructions form a coherent design sequence (aggregates → events → command handlers → projections → sagas → snapshotting → versioning), but there are no validation checkpoints, decision gates, or feedback loops anywhere (e.g., verifying projections against the event stream after rebuild). This is an architecture-design skill, not a destructive/batch operation, so the hard cap of 3 for missing validation does not apply, but the sequence-without-checkpoints pattern matches anchor 3; it does not reach 4's 'most checkpoints present'.

3 / 5

Progressive Disclosure

A single well-organized file under 60 lines with clear section headers (Capabilities, Use when, Do not use, Instructions, Safety, Best Practices), no buried content, and no external references needed for this overview-level material. Per the small-skill guideline, well-organized sections with no need for bundle files warrant the top score; the only cross-links ('Related Skills') are clearly signaled skill pointers, not hidden file references.

5 / 5

Total

15

/

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: third-person voice, explicit 'Use when' triggers, and specific named capabilities in the event-sourcing/CQRS domain. The only weaknesses are mastery-claim framing instead of action verbs and a couple of natural trigger synonyms (saga, projections, event store) appearing only on the capability side.

DimensionReasoningScore

Specificity

Lists several specific capability areas ("event store design, projection building, saga orchestration, and eventual consistency patterns") with only minor gaps, but frames them as mastery claims ("Expert in", "Masters") rather than concrete actions. Not a 5 because the coverage is broad-but-terse and lacks the action-verb density of the top anchor; not a 3 because multiple distinct concrete capabilities are named, matching 'several specific actions with minor gaps'.

4 / 5

Completeness

Clearly answers both 'what' ("Masters event store design, projection building, saga orchestration, and eventual consistency patterns") and 'when' ("Use PROACTIVELY for event-sourced systems, audit trail requirements, or complex domain modeling with temporal queries") with concrete trigger phrases, exactly matching the top anchor. It is not below 5 because neither half is missing or vague.

5 / 5

Trigger Term Quality

Includes the natural phrases users would say ("event sourcing", "CQRS", "event-driven", "audit trail", "temporal queries") and an explicit trigger clause ("Use PROACTIVELY for event-sourced systems, audit trail requirements"). Not a 5 because a few natural synonyms (event store, saga, projections) appear only in the capability half rather than as triggers; not a 3 because keyword coverage is good, not merely partial.

4 / 5

Distinctiveness Conflict Risk

The event-sourcing/CQRS niche is well-delineated and unlikely to trigger the wrong skill, though "complex domain modeling" is broad enough to overlap with general DDD/architecture skills. Not a 5 because of that minor overlap risk with closely related architecture skills; not a 3 because the core domain terms are highly specific.

4 / 5

Total

17

/

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

plugins/AI-Agents-Safe-Coding-Skills/skills/event-sourcing-architect/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.