CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dotnet-architect

Expert .NET backend architect specializing in C#, ASP.NET Core, Entity Framework, Dapper, and enterprise application patterns.

Quality

56%

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 ./skills/dotnet-architect/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

38%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 padded persona résumé: a long catalog of well-known .NET technologies and generic behavioral traits with boilerplate template sections ('Clarify goals, constraints, and required inputs'), plus a dangling reference to a nonexistent resources/implementation-playbook.md. Its one strong element is the concrete, executable Code Style Preferences example, which partially redeems actionability.

Suggestions

Fix the broken reference: either create references/implementation-playbook.md (using the standard references/ directory) and point detailed examples there, or remove the pointer entirely.

Cut the Capabilities, Behavioral Traits, Knowledge Base, and Example Interactions catalog drastically — Claude already knows these technologies — keeping only the project-specific preferences (e.g., Result pattern, preferred test stack, code style) that differ from Claude's defaults.

Replace the generic 'Instructions' boilerplate and vague 'Response Approach' steps with a concrete workflow with validation checkpoints (e.g., how to verify EF query performance, what to check before recommending an architecture).

DimensionReasoningScore

Conciseness

The body (~190 lines) is dominated by an encyclopedic catalog of technologies and practices Claude already knows ('Modern C# features (12/13): required members, primary constructors', 'IMemoryCache for in-process caching', 'xUnit test framework', 'Docker containerization') plus behavioral-trait padding ('Favors composition over inheritance', 'Applies SOLID principles pragmatically'). This matches anchor 2 ('Noticeably verbose; several unnecessary explanations or padded sections') — several sections, not just one or two, earn nothing; it stops short of anchor 1 only because the Code Style Preferences section conveys genuine project-specific preference.

2 / 5

Actionability

Most of the body is abstract capability listing with no steps or commands ('Writes idiomatic, modern C# code', 'Consider edge cases including error handling and concurrency'), but the Code Style Preferences section provides one complete, executable C# example demonstrating concrete preferences (primary constructors, records, switch expressions, Result pattern). This straddles anchors 2 and 3 — it has some real concrete guidance, but it is incomplete and isolated, so 3 is the best fit.

3 / 5

Workflow Clarity

The 'Response Approach' section lists a clear 8-step sequence (understand requirements → design architecture → implement → optimize → ensure testability → document → consider edge cases → review security), but the steps are generic and include no validation checkpoints or feedback loops ('Apply relevant best practices and validate outcomes' is not a checkable step). This matches anchor 3 ('Steps listed but validation gaps; sequence present but checkpoints missing or implicit').

3 / 5

Progressive Disclosure

The only reference in the body is 'If detailed examples are required, open resources/implementation-playbook.md' — a path that does not exist in the bundle (no resources/, references/, scripts/, or assets/ directories), and the standard references/ directory is not used. Meanwhile, the large capability catalog that belongs in a separate reference file is fully inlined. This matches anchor 2 ('Minimal structure; content that clearly belongs in separate files is inlined; or references are buried'), aggravated by the broken reference path.

2 / 5

Total

10

/

20

Passed

Description

56%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.

The description effectively names a specific .NET backend stack, giving it good trigger keywords and reasonable distinctiveness, but it is a persona label rather than a capability statement: no concrete actions and no 'use when' guidance. Completeness is capped by the missing trigger clause.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when designing or reviewing ASP.NET Core APIs, EF Core/Dapper data access, or .NET microservices.'

Convert the role statement into 3-4 concrete actions, e.g. 'Reviews and designs ASP.NET Core APIs, optimizes EF Core/Dapper queries, and applies Clean Architecture patterns.'

Include common synonyms such as '.NET', 'dotnet', 'EF Core', and 'microservices' to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description is a role statement ('Expert .NET backend architect specializing in C#, ASP.NET Core, Entity Framework, Dapper, and enterprise application patterns') that names the domain and technology stack but lists no concrete actions — it never says what the skill does (design APIs, review code, optimize queries). This matches anchor 2 ('Names the domain but actions are minimal or generic'); it is above anchor 1 because the technologies are specific, and below anchor 3 because no discrete capabilities/actions are stated.

2 / 5

Completeness

There is a reasonably clear 'what' (an architect persona specializing in a specific stack), but the 'when' is entirely absent — no 'Use when...' clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3. This is exactly anchor 3 ('Has a clear what but when is missing or only weakly implied'), not 4, because nothing tells Claude when to invoke this skill.

3 / 5

Trigger Term Quality

It includes strong natural keywords users would actually say — 'C#', 'ASP.NET Core', 'Entity Framework', 'Dapper', 'enterprise application patterns' — which matches anchor 4 ('Good keyword coverage; a few natural terms missing'). It falls short of anchor 5 because common variations and synonyms are absent: no '.NET' spelled out, no 'dotnet', 'EF Core', 'API', 'microservices', or file extensions.

4 / 5

Distinctiveness Conflict Risk

The stack-specific framing (C#, ASP.NET Core, EF, Dapper) makes it mostly distinct from skills in other domains, matching anchor 4 ('Mostly distinct; minor overlap risk with closely related skills'). It is not a 5 because it could still collide with a general C#/.NET coding-assistant or architect skill since no distinct trigger phrase separates them.

4 / 5

Total

13

/

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

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