CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

microservices-architect

Designs distributed system architectures, decomposes monoliths into bounded-context services, recommends communication patterns, and produces service boundary diagrams and resilience strategies. Use when designing distributed systems, decomposing monoliths, or implementing microservices patterns — including service boundaries, DDD, saga patterns, event sourcing, CQRS, service mesh, or distributed tracing.

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 body is well structured: an explicitly validated six-step workflow, executable-leaning code examples, and excellent progressive disclosure through a Load-When reference table pointing at real files. The main drag is token efficiency — a closing concept-list section and some padded framing restate knowledge Claude already has — and minor completeness gaps in the code examples.

Suggestions

Delete the "Knowledge Reference" section — it lists concepts (DDD, Kafka, Istio, CAP theorem) Claude already knows and adds no actionable guidance; the triggers metadata already covers discovery.

Make the code examples fully self-contained: add `import requests` and define/annotate `logger`, `INVENTORY_URL`, and the saga context variables so each snippet is copy-paste runnable.

Trim the "Senior distributed systems architect..." opener and merge overlapping MUST/MUST-NOT items (e.g., async-communication rules appear in both the workflow checkpoint and both constraint lists) to cut redundant tokens.

DimensionReasoningScore

Conciseness

The workflow, constraints, and code examples are mostly lean, but the closing "Knowledge Reference" section is a buzzword inventory of concepts Claude already knows ("Domain-driven design, bounded contexts... Kafka, RabbitMQ... Istio, Linkerd... CAP theorem"), and the "Senior distributed systems architect specializing in..." opener plus the partially redundant MUST/MUST-NOT lists add padding. This matches anchor 3 (mostly efficient but includes some unnecessary explanation) rather than anchor 4, where only minor trimmable instances remain.

3 / 5

Actionability

Four concrete code examples (correlation-ID middleware, pybreaker circuit breaker, saga orchestration, Kubernetes probes) are nearly copy-paste ready, but each has small gaps: the middleware uses an undefined `logger`, the Python example omits `import requests` and uses an undefined `INVENTORY_URL`, and the saga usage references undefined `orderId`/`customerId`. This fits anchor 4 (mostly executable with minor gaps) rather than anchor 5's fully executable, common-case-covering examples.

4 / 5

Workflow Clarity

The six-step Core Workflow is clearly sequenced and every step carries an explicit validation checkpoint (e.g., "No shared database schema exists between services", "Every external call has an explicit timeout, retry budget, and graceful degradation path"), which is stronger than anchor 4's "most checkpoints present" and matches anchor 5's explicit validation steps. The checkpoints are pass/fail criteria rather than full error-recovery loops, but no step lacks validation.

5 / 5

Progressive Disclosure

The body is a genuine overview: a reference table maps five topics to real files (all five `references/*.md` exist on disk) with a "Load When" column signaling exactly when to open each, and references are one level deep with no nested indirection. Code examples inline are illustrative and appropriately sized for the main file, matching anchor 5's well-signaled, easy-to-navigate structure.

5 / 5

Total

17

/

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 states multiple concrete capabilities and pairs them with an explicit, trigger-rich "Use when" clause. Its weaknesses are minor: a couple of generic verbs dilute specificity, and a few natural synonyms (e.g., spelled-out "domain-driven design") would improve trigger coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "decomposes monoliths into bounded-context services", "produces service boundary diagrams and resilience strategies" — but "Designs distributed system architectures" and "recommends communication patterns" are more generic, leaving minor gaps in coverage (e.g., deployment/observability work is only implied). It matches anchor 4 (several specific actions, minor gaps) better than anchor 5, whose actions are all fully concrete, and clearly above anchor 3's 1-2 concrete actions.

4 / 5

Completeness

It explicitly answers both questions: the "what" via four named capabilities ("Designs... decomposes... recommends... produces...") and the "when" via "Use when designing distributed systems, decomposing monoliths, or implementing microservices patterns — including..." with concrete trigger phrases. This matches anchor 5 exactly; it is well above anchor 4, where the "when" clause is present but weaker or less specific.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases users would say: "decomposing monoliths", "service boundaries", "saga patterns", "event sourcing", "CQRS", "service mesh", "distributed tracing". A few natural terms are missing — "domain-driven design" appears only as the abbreviation "DDD", and Kubernetes/API-gateway-adjacent phrasings are absent from the description — so it fits anchor 4 rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The microservices niche is well defined with distinctive triggers (saga, CQRS, event sourcing, service mesh), but "Use when designing distributed systems" is broad enough to overlap with a general system-architecture or devops skill. Anchor 4 (mostly distinct, minor overlap risk with closely related skills) fits better than anchor 5's minimal-conflict clear niche.

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

Jeffallan/claude-skills

Path

skills/microservices-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.