CtrlK
BlogDocsLog inGet started
Tessl Logo

coding-standards

C# and .NET coding standards for generating new code files. Use when creating new classes, methods, controls, tests, or any new C# / VB source files in this repository. Covers C# 14 / .NET 10 patterns, naming, formatting, XML docs, WinForms conventions, and performance idioms.

68

Quality

85%

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

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

A well-crafted standards reference: concrete, idiomatic, repo-specific rules with executable examples and no padding of concepts Claude already knows. The main defects are an unclosed code fence in the Magic Numbers section that breaks rendering and swallows the XML Documentation heading, plus elided examples in the C# 14 feature table.

Suggestions

Close the code fence in the Magic Numbers section and add the intended before/after example — currently the fence at line 346 is left open, rendering '## XML Documentation' and its intro inside a code block.

Replace '...' elisions in the C# 14 feature table with complete one-line examples (e.g. a full IsBlank() body) so every example is executable.

Deduplicate the tuple-deconstruction example (appears at both line 99 and line 139) and consider moving the WinForms-specific and XML documentation sections into reference files to slim the main SKILL.md.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — it never explains what C# or .NET is, and every rule encodes non-obvious repo-specific conventions. It falls short of anchor 5 ('every token earns its place') due to minor redundancy, e.g. the tuple-deconstruction example appears twice (lines 99 and 139) and some Before/After pairs in the var-policy section could be trimmed to one example each.

4 / 5

Actionability

Mostly executable guidance with concrete, copy-paste-ready C# snippets (throw-helpers, switch expressions, Dispose pattern). Not a 5 because of minor gaps: the C# 14 feature table uses elided pseudocode like 'public bool IsBlank() => ...', and the Magic Numbers section (line 346) opens an unclosed ```csharp fence with no example at all, rendering the following XML Documentation heading inside a code block.

4 / 5

Workflow Clarity

This is a single-purpose standards skill with an unambiguous application rule ('apply whenever you generate new C# or VB.NET source files'), and the var-policy rules are even sequenced in explicit priority order. It does not reach 5 because the unclosed code fence at line 346 breaks the rendered section structure, muddying navigation through the last third of the document.

4 / 5

Progressive Disclosure

No bundle files exist; the single SKILL.md is organized into clear, well-ordered sections (var policy, naming, formatting, WinForms) with no nested references. Good structure with minor gaps: at ~420 lines, cohesive but bulky sections such as WinForms-specific and XML documentation could be split into reference files to keep the overview leaner.

4 / 5

Total

16

/

20

Passed

Description

87%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: third-person, explicit 'Use when' triggers, concrete coverage areas, and a clearly bounded scope. Minor headroom remains in trigger-term breadth (file extensions, synonyms like 'conventions').

DimensionReasoningScore

Specificity

The description lists several concrete coverage areas — "C# 14 / .NET 10 patterns, naming, formatting, XML docs, WinForms conventions, and performance idioms" — which matches the anchor 'lists several specific actions; minor gaps in coverage'. It is not a 5 because the core action is stated generically as 'coding standards for generating new code files' rather than multiple concrete operations, and items like error-handling/throw-helpers covered in the body go unmentioned.

4 / 5

Completeness

It explicitly answers both: what ('C# and .NET coding standards for generating new code files... Covers C# 14 / .NET 10 patterns, naming, formatting...') and when ('Use when creating new classes, methods, controls, tests, or any new C# / VB source files in this repository'), with concrete trigger phrases — a clean match for the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'.

5 / 5

Trigger Term Quality

Trigger phrases like "creating new classes, methods, controls, tests, or any new C# / VB source files" are natural things a user would say, plus keywords "C#", ".NET", "VB", "WinForms". It falls just short of the anchor-5 'comprehensive coverage including synonyms and file extensions' because file extensions (.cs, .vb) and common phrasings like 'conventions' or 'style' are missing.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — standards for generating new C#/.NET source files in this repository, including WinForms specifics — and the body further distinguishes it from the separate 'code-modernization' skill, minimizing wrong-skill triggering.

5 / 5

Total

18

/

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