CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

provisioning-library-generation

Generate new Azure.Provisioning.* libraries OR regenerate existing ones. Use when introducing a brand-new provisioning library, adding new resource types, enum values, or API versions.

Quality

87%

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

85%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 strong, highly actionable regeneration workflow with explicit sequencing, validation checkpoints, and recovery loops. Its main weaknesses are a dangling ONBOARDING.md reference that breaks the onboarding path, and some duplicated content between the Examples/Troubleshooting sections and the numbered steps.

Suggestions

Create the referenced ONBOARDING.md file (or inline the onboarding steps, or remove the reference) — the Workflow Selection section currently dead-ends onboarding users at a nonexistent file.

Trim duplication: Example B re-lists all 7 resource types already shown in Step 2B, and several Troubleshooting entries repeat Steps 2B and 4 verbatim; summarize or cross-link instead.

Consider moving the worked Examples and the breaking-change catalog into a references/ file linked one level deep, keeping SKILL.md as a tighter overview of the decision tree and core steps.

DimensionReasoningScore

Conciseness

The body is almost entirely commands, code, and file paths with no concept-explanation padding ('Navigate to the generator directory and run: dotnet run --framework net10.0 -- --filter {ServiceName}'), but Example B re-lists all 7 resource types already exemplified in Step 2B, and the Troubleshooting section repeats Step 2B/Step 4 guidance ('Use OrderEnum<T>() in the specification file', 'backward-compatible stubs'). These minor duplications could be trimmed, fitting the 'efficient; minor instances of over-explanation' anchor rather than the fully lean anchor 5.

4 / 5

Actionability

Guidance is fully executable throughout: exact commands ('git status --short -- sdk/provisioning/', 'git checkout main -- sdk/provisioning/Azure.Provisioning/'), exact paths ('eng/apicompatbaselines/Azure.Provisioning.{Service}.xml'), complete XML/YAML/C# snippets with real values ('Changed Azure.ResourceManager.PostgreSql from 1.3.1 to 1.4.1'), and two worked examples covering the version-update and whitelist cases. It clearly matches anchor 5 rather than anchor 4, whose examples still have 'minor gaps' — the only quibbles here are inherent {Service} placeholders and a Step 6 vs Example A check-command inconsistency.

5 / 5

Workflow Clarity

Clear routing ('Start here: Use Workflow Selection'), conditional branching (Step 1 → 2A/2B), and explicit validation with feedback loops: 'Verify Only Target Library Changed' via git status, revert instructions for non-target libraries, a generator-error protocol ('Stop and let the user decide'), and pre-commit checks. This matches anchor 5's 'explicit validation steps; feedback loops for error recovery; checklists' — the batch-regeneration risk is covered by the verify-and-revert checkpoint, so the batch-operation cap at 3 does not apply.

5 / 5

Progressive Disclosure

The only intra-bundle reference — 'Read and follow ONBOARDING.md in this skill directory' — points to a file that does not exist (the bundle contains only SKILL.md; no references/, scripts/, or assets/ directories), leaving onboarding users at a dead end. Structure and navigation are otherwise good, but a broken critical reference plus ~250 lines with worked Examples and a Troubleshooting section inlined fits anchor 3 ('references present but not clearly signaled; content that should be separate is inline') better than anchor 4, whose gaps are merely minor.

3 / 5

Total

17

/

20

Passed

Description

82%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 that explicitly covers both what the skill does and when to use it, with a highly distinctive niche and good trigger terms. Its only weakness is modest action coverage — generate/regenerate is the extent of the stated capability list.

DimensionReasoningScore

Specificity

The description names the domain precisely ('Azure.Provisioning.* libraries') and states two concrete actions ('Generate new ... OR regenerate existing ones'), but does not cover what the skill actually involves (running the generator, version updates, breaking-change handling). This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') rather than anchor 4, which expects several distinct listed actions.

3 / 5

Completeness

It explicitly answers both questions with concrete trigger phrases: what ('Generate new Azure.Provisioning.* libraries OR regenerate existing ones') and when ('Use when introducing a brand-new provisioning library, adding new resource types, enum values, or API versions'). This is a direct match for anchor 5; anchor 4 would require the 'when' to be less explicit or specific.

5 / 5

Trigger Term Quality

Natural terms a user would say are present: 'provisioning library', 'adding new resource types', 'enum values', 'API versions'. Coverage is good but misses common variations like 'onboard/onboarding' (used in the body but absent here) and package-name patterns users would paste, fitting anchor 4 ('good keyword coverage; a few natural terms missing') rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

'Azure.Provisioning.*' is a clear niche with distinct, domain-specific triggers unlikely to collide with generic library- or code-generation skills, matching anchor 5 ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

17

/

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

Azure/azure-sdk-for-net

Path

.github/skills/provisioning-library-generation/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.