CtrlK
BlogDocsLog inGet started
Tessl Logo

common-system-design

Enforce separation of concerns, dependency inversion, and resilience patterns across layered and distributed architectures. Use when designing new features, evaluating module boundaries, selecting architectural patterns, or resolving scalability bottlenecks.

64

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

A well-structured, token-efficient architectural standards skill with good progressive disclosure into real reference files. It is held back by descriptive rather than actionable workflow steps and the absence of validation checkpoints in its evaluation workflow.

Suggestions

Add an explicit validation checkpoint to the 'Evaluate Architecture' workflow (e.g. 'Verify each boundary has a single reason to change; if not, split the module before proceeding').

Convert key bullets into concrete, executable checks or decision rules (e.g. a CAP decision rule tied to the referenced decision tree) rather than definitional statements.

Make the dependency-direction guidance actionable with a short example of allowed vs. disallowed imports rather than a one-line assertion.

DimensionReasoningScore

Conciseness

Lean one-liner definitions ('SoC', 'SSOT', 'Fail Fast') with no padding and no explanation of concepts Claude already knows — every token earns its place.

3 / 3

Actionability

For a standards skill the guidance is concrete (dependency direction, pattern lists, CAP trade-offs), but it is largely descriptive/definitional rather than executable instructions — matches the 'some concrete guidance but incomplete' anchor.

2 / 3

Workflow Clarity

The 5-step 'Evaluate Architecture' workflow is sequenced, but lacks explicit validation checkpoints or feedback loops; the ADR step is a documentation step rather than a validation gate — matches the 'steps listed but validation gaps' anchor.

2 / 3

Progressive Disclosure

SKILL.md is a concise overview with well-signaled one-level-deep links to three real bundle files (distributed-systems.md, resilience-patterns.md, implementation.md), all of which exist and are referenced contextually — matches the 'clear overview with well-signaled one-level-deep references' anchor.

3 / 3

Total

10

/

12

Passed

Description

85%

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 explicit what/when structure and concrete, distinctive architectural actions. Its main weakness is trigger phrasing that favors technical jargon over the words a user would naturally say.

Suggestions

Reword triggers toward natural user phrasing (e.g. add 'system design', 'architecture', 'scalability', 'microservices') alongside the current technical terms.

Consider adding a few common synonyms users say ('how should I structure this', 'decoupling', 'service boundaries') to broaden trigger coverage.

DimensionReasoningScore

Specificity

Lists multiple concrete actions ('Enforce separation of concerns, dependency inversion, and resilience patterns') plus design activities (designing features, evaluating module boundaries, selecting patterns, resolving bottlenecks) — closest to the 'multiple specific concrete actions' anchor.

3 / 3

Completeness

Explicitly states what it does ('Enforce... resilience patterns across layered and distributed architectures') and provides an explicit 'Use when...' clause enumerating triggers, clearly answering both what and when.

3 / 3

Trigger Term Quality

Triggers like 'designing new features' and 'evaluating module boundaries' are relevant but lean technical/architectural jargon ('separation of concerns', 'dependency inversion') rather than terms users naturally say, missing common variations — matches the 'some relevant keywords but missing common variations' anchor.

2 / 3

Distinctiveness Conflict Risk

Occupies a clear system-design/architecture niche with distinct triggers unlikely to overlap with unrelated skills — matches the 'clear niche with distinct triggers' anchor.

3 / 3

Total

11

/

12

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
HoangNguyen0403/agent-skills-standard
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.