CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cosmos-provider

Implementation details for the EF Core Azure Cosmos DB provider. Use when changing Cosmos-specific code.

63

Quality

79%

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 ./.agents/skills/cosmos-provider/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 an exemplary lean reference: project-specific facts, exact API names, env vars, and a copy-paste test attribute with zero filler. The only improvement space is showing rather than merely naming the partition key configuration requirement.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: 'Non-relational provider with its own parallel query pipeline. Uses JSON for document materialization.' Every bullet conveys project-specific knowledge Claude would not already have (no migrations, ETag concurrency, Linux emulator limitations, exact env var and skip-attribute). Every token earns its place, matching anchor 5.

5 / 5

Actionability

Concrete, mostly copy-paste-ready guidance: '`EnsureCreated()`', the env var '`Test__Cosmos__DefaultConnection`', and the exact 'ConditionalFact(typeof(CosmosTestEnvironment), nameof(CosmosTestEnvironment.IsNotLinuxEmulator))' attribute. Minor gaps remain — e.g. partition key configuration is mentioned as required but no example is given — so anchor 4 rather than 5.

4 / 5

Workflow Clarity

This is a single-purpose reference skill with no multi-step process, and its guidance is unambiguous (use EnsureCreated instead of migrations, ETag for concurrency, skip attribute for unsupported emulator features). It falls just short of a clean 5 because items like 'Partition key configuration required for performance' state a requirement without showing how to satisfy it.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no external bundle files, and the content is appropriately organized into a two-line overview plus clearly headed 'Key Differences' and 'Emulator for Tests' sections. Per the simple-skill guideline this warrants a 5 with no external references needed.

5 / 5

Total

18

/

20

Passed

Description

61%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 is distinct and has an explicit use-when clause, but the capability statement is generic — 'Implementation details' names no concrete actions and trigger synonyms are thin. It reads more like a file-path label than a capability description.

Suggestions

Replace the vague 'Implementation details' with 2-3 concrete capabilities, e.g. 'Covers Cosmos-specific query pipeline, JSON document mapping, partition key configuration, and optimistic concurrency via ETag'.

Broaden trigger terms to natural variations: 'Use when changing Cosmos DB provider code, working with Cosmos-specific EF Core configuration, or debugging Cosmos query translation'.

Consider adding '.NET' or 'NoSQL' adjacent phrasing so users who describe the work in different words still surface this skill.

DimensionReasoningScore

Specificity

The description names the domain ('EF Core Azure Cosmos DB provider') but the only stated action is the generic phrase 'Implementation details', with no concrete capabilities listed. This matches the anchor 'Names the domain but actions are minimal or generic' rather than anchor 3, which requires 1-2 concrete actions.

2 / 5

Completeness

Both parts are present: a what ('Implementation details for the EF Core Azure Cosmos DB provider') and an explicit when ('Use when changing Cosmos-specific code'). It sits at anchor 4 rather than 5 because the 'what' is vague and the trigger is a single narrow phrase; it is above anchor 3 because the 'when' is explicit rather than implied.

4 / 5

Trigger Term Quality

'Use when changing Cosmos-specific code' supplies a natural trigger term ('Cosmos'), but common variations users might say — 'Cosmos DB', 'NoSQL', 'document database', 'Cosmos provider' — are absent. Relevant keywords exist but synonyms and variations are missing, matching anchor 3.

3 / 5

Distinctiveness Conflict Risk

'EF Core Azure Cosmos DB provider' carves out a clear niche with distinct, unambiguous triggers; no other plausible skill would fire on this description. Minimal conflict risk, matching anchor 5.

5 / 5

Total

14

/

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

Path

.agents/skills/cosmos-provider/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.