CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

extensions-review

Guidance for writing and modifying Microsoft.Extensions.* and System.IO.Compression code in dotnet/runtime. Covers DI lifetime management, configuration binding, options validation, logging provider patterns, caching semantics, compression format compliance, and host lifecycle. For full code review, delegates to the @extensions-reviewer agent. Trigger words: Microsoft.Extensions, IServiceCollection, IConfiguration, ILogger, IHost, IMemoryCache, IOptions, ZipArchive, HttpClientFactory, IFileProvider, IChangeToken.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

90%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 dense, highly actionable reference: executable examples and decision trees throughout, no filler, and testing/compatibility rules that encode repo-specific knowledge. The main gaps are the absence of an explicit end-to-end workflow with feedback loops and no use of reference files to split the eight sub-domains.

DimensionReasoningScore

Conciseness

The body is lean: decision trees, terse bullets, and code with essentially no padding and no explanations of concepts Claude already knows — even code comments encode repo-specific conventions ('NEVER inject into a Singleton — captive dependency!', 'Graceful shutdown — expected'). Every token earns its place, matching the top anchor.

5 / 5

Actionability

Fully executable, copy-paste-ready C# covers the common cases: TryAdd registrations, IValidateOptions with ValidateOnStart, [LoggerMessage] source generation, HybridCache stampede-safe caching, BrotliStream async compression, Unix permission preservation on extraction, and a graceful-shutdown BackgroundService. The WRONG/CORRECT pairs make correct and incorrect patterns concrete.

5 / 5

Workflow Clarity

Decision trees ('Is the service stateless or immutable after construction?', 'Is the app trimmed or AOT-published?') give clear branching procedures, and some explicit checkpoints exist ('verify the container disposes it at shutdown', 'Verify with PublishAot=true that no new IL2xxx warnings are introduced'). It is guidance-reference rather than a multi-step pipeline, and lacks feedback loops and an end-to-end checklist, so it sits at 'clear sequence with most checkpoints; minor validation gaps' rather than 5.

4 / 5

Progressive Disclosure

The single 245-line file is well-organized with clear section headers, and there are no bundle files to navigate (no references/, scripts/, or assets/ exist). Structure is good and content is appropriately dense for a working reference, but eight distinct sub-domains (compression, testing, host lifecycle, etc.) all live inline with no one-level-deep reference files to split them into, leaving minor organization gaps rather than the fully leveraged split of a 5.

4 / 5

Total

18

/

20

Passed

Description

92%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, well-scoped description in third-person voice that clearly states what the skill covers and provides an explicit trigger-term list. The only weakness is that the trigger terms are all API/type names, missing the natural-language synonyms a user might use when asking for help.

DimensionReasoningScore

Specificity

Names the precise domain ('Microsoft.Extensions.* and System.IO.Compression code in dotnet/runtime') and enumerates seven concrete coverage areas ('DI lifetime management, configuration binding, options validation, logging provider patterns, caching semantics, compression format compliance, and host lifecycle') plus a concrete delegation behavior ('delegates to the @extensions-reviewer agent'). Comprehensive coverage with no visible gaps, matching the top anchor rather than the 'minor gaps' of a 4.

5 / 5

Completeness

Explicitly answers both 'what' ('Guidance for writing and modifying Microsoft.Extensions.* and System.IO.Compression code in dotnet/runtime' with an enumerated scope list) and 'when' via the explicit trigger clause 'Trigger words: Microsoft.Extensions, IServiceCollection, …'. The 'Use when' cap at 3 does not apply because explicit trigger guidance is present.

5 / 5

Trigger Term Quality

Lists eleven natural, high-signal trigger terms users would say in this domain ('IServiceCollection', 'IOptions', 'ZipArchive', 'IHost', 'IFileProvider'). However, colloquial synonyms a user would naturally type — 'dependency injection', 'options pattern', 'BackgroundService', 'Brotli'/'gzip' — are absent, fitting 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

A clearly defined niche (dotnet/runtime extensions and compression libraries) with distinctive type-name triggers ('ZipArchive', 'IMemoryCache', 'IChangeToken') that no generic skill would claim; minimal conflict risk despite slight generic-sounding terms like 'IConfiguration'.

5 / 5

Total

19

/

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/runtime

Path

.github/skills/extensions-review/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.