CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/separation-of-concerns

Enforce strict three-layer architecture: thin HTTP routes, pure service logic with domain errors, isolated data access with dependency injection.

94

1.08x
Quality

93%

Does it follow best practices?

Impact

97%

1.08x

Average score across 5 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that clearly articulates a specific architectural pattern and provides comprehensive trigger conditions. It uses third person voice correctly, lists concrete actions and anti-patterns, and includes an explicit 'Use when' clause with multiple specific scenarios that would naturally arise in developer conversations.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'thin HTTP routes', 'pure service logic', 'isolated data access'. Also describes specific anti-patterns to address like 'route handlers contain database queries' and 'business logic mixed with HTTP parsing'.

3 / 3

Completeness

Clearly answers both what ('Enforce strict three-layer architecture: thin HTTP routes, pure service logic, isolated data access') and when with explicit 'Use when' clause listing five specific trigger scenarios.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms: 'web API', 'route handlers', 'database queries', 'business logic', 'HTTP parsing', 'req/res', 'error handling', 'test logic', 'server'. These are terms developers would naturally use when discussing architecture problems.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with clear niche around three-layer architecture for web APIs. The specific anti-patterns mentioned (req/res in services, database queries in routes) create unique triggers unlikely to conflict with general coding or other architecture skills.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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

This is a strong, well-structured skill that provides actionable guidance for implementing separation of concerns in web APIs. The executable code examples, clear BAD/GOOD comparisons, and comprehensive checklist make it highly actionable. Minor verbosity in explanatory sections prevents a perfect conciseness score, but the content earns its place overall.

DimensionReasoningScore

Conciseness

The skill is comprehensive but somewhat verbose. The table format is efficient, but some patterns repeat similar concepts (e.g., the 'BAD/GOOD' examples could be tighter). The explanatory text like 'Why this matters' adds value but could be condensed.

2 / 3

Actionability

Excellent executable code examples throughout. Every pattern includes complete, copy-paste ready TypeScript code with clear BAD/GOOD comparisons. The error handling, repository, and dependency injection patterns are fully implementable.

3 / 3

Workflow Clarity

Clear three-layer architecture with explicit responsibilities table. The validation pattern explicitly shows two-level validation flow. The checklist at the end provides verification steps. Error mapping workflow is clearly sequenced with re-throw guidance.

3 / 3

Progressive Disclosure

Well-structured with clear sections progressing from architecture overview to specific patterns to file organization to checklist. References to verifiers at the end provide one-level-deep navigation. Content is appropriately organized without being monolithic.

3 / 3

Total

11

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Reviewed

Table of Contents