CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/aspnet-project-structure

ASP.NET Core project structure — minimal APIs vs controllers, layer

95

2.50x
Quality

93%

Does it follow best practices?

Impact

100%

2.50x

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 a strong skill description that clearly defines its scope within the ASP.NET Core ecosystem. It lists specific architectural patterns and configurations, includes natural developer terminology, and provides explicit guidance on when to apply the skill proactively. The description effectively distinguishes itself from generic coding or architecture skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and patterns: 'Clean Architecture layers, minimal APIs vs controllers, IServiceCollection extensions, IOptions pattern, EF Core DbContext configuration, and proper DTO separation' - these are all specific, actionable architectural concepts.

3 / 3

Completeness

Clearly answers both what (project structure patterns and configurations) AND when ('Apply proactively when building any .NET API, even when the user does not ask for structure guidance') with explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes natural keywords developers would use: 'ASP.NET Core', '.NET API', 'Clean Architecture', 'minimal APIs', 'controllers', 'EF Core', 'DbContext', 'DTO' - good coverage of terms a .NET developer would naturally mention.

3 / 3

Distinctiveness Conflict Risk

Highly specific to ASP.NET Core ecosystem with distinct triggers like 'EF Core', 'IServiceCollection', 'IOptions pattern' - unlikely to conflict with general coding skills or other language-specific 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 highly actionable guidance for ASP.NET Core project organization. The code examples are complete and executable, the decision rules are clear, and the checklist provides good validation. Minor verbosity in explanatory text prevents a perfect conciseness score, but overall this skill effectively teaches the patterns without over-explaining concepts Claude already knows.

DimensionReasoningScore

Conciseness

The skill is mostly efficient with good code examples, but includes some unnecessary explanations Claude would know (e.g., explaining what DTOs are, why to separate concerns). Some sections like the decision rule explanations could be tightened.

2 / 3

Actionability

Excellent actionability with fully executable, copy-paste ready code examples throughout. Every pattern includes complete C# code with proper namespaces, file paths, and implementation details. The folder structures are concrete and specific.

3 / 3

Workflow Clarity

Clear decision rules for choosing API styles, explicit sequencing in the checklist, and well-defined patterns for each architectural layer. The checklist at the end provides explicit validation checkpoints for project setup.

3 / 3

Progressive Disclosure

Well-organized with clear section headers, appropriate content depth for a SKILL.md overview, and references to external verifiers at the end. Content is logically structured from high-level decisions down to specific implementations without excessive nesting.

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