CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azsdk-common-sdk-release

Check release readiness and trigger the release pipeline for Azure SDK packages. **UTILITY SKILL**. USE FOR: "release SDK", "trigger release", "check release readiness", "release pipeline", "publish package", "ship SDK". DO NOT USE FOR: SDK development, code generation, pipeline debugging, release plan creation. INVOKES: azure-sdk-mcp:azsdk_release_sdk.

67

Quality

84%

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

78%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-structured, actionable single-purpose skill body with concrete parameters and a clear step sequence including error recovery. The main issues are minor redundancy with the description and an internal contradiction about whether a readiness check precedes direct release triggering.

Suggestions

Resolve the contradiction between the Rules ('run the readiness check before attempting to trigger release') and Step 2-3 (trigger directly with checkReady: false unless the user explicitly asks) — either mandate the readiness check first or clarify that checkReady: false performs the check inline.

Remove or compress the Triggers section, which duplicates the description's USE FOR/DO NOT USE FOR text verbatim, and consolidate the MCP-server requirement stated in both Rules and Troubleshooting.

Add one concrete example invocation of azure-sdk-mcp:azsdk_release_sdk (with packageName, language, and checkReady) to make the guidance copy-paste ready for the common cases.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence (no conceptual explanations), but the Triggers section restates the description's USE FOR/DO NOT USE FOR text verbatim and the MCP-server requirement appears in both Rules and Troubleshooting. These are minor redundancies that could be trimmed, fitting anchor 4 rather than the fully lean anchor 5 or the noticeably padded anchor 3.

4 / 5

Actionability

Concrete guidance throughout: exact tool name ('azure-sdk-mcp:azsdk_release_sdk'), exact parameters (packageName, language, branch defaulting to main, checkReady true/false), and specific post-trigger behavior ('Show pipeline link and inform user they must approve the release stage'). It stops short of anchor 5 because no example tool invocation or parameter payload is shown for the common cases.

4 / 5

Workflow Clarity

Steps 1-4 are clearly sequenced with an error-recovery loop (step 4 plus Troubleshooting), but there is a validation contradiction: Rules say 'run the readiness check before attempting to trigger release' while Steps 2-3 trigger directly with checkReady: false unless the user explicitly asks for a readiness check. This minor validation gap fits anchor 4; the explicit feedback loop and sequencing rule out 3, and the inconsistency rules out 5.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and needs no external reference files; sections (Triggers, Rules, MCP Tools, Steps, Examples, Troubleshooting) are well-organized and easy to navigate. Per the rubric's simple-skill guideline, this earns anchor 5 with just well-organized sections.

5 / 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: it states what the skill does, gives explicit USE FOR/DO NOT USE FOR boundaries with natural trigger phrases, and names the invoked MCP tool. The only soft spot is that just two concrete actions are named, leaving capability coverage slightly thin.

DimensionReasoningScore

Specificity

The description names the domain ('Azure SDK packages') and exactly two concrete actions ('Check release readiness and trigger the release pipeline'), matching the anchor for 1-2 concrete actions. It does not list several specific actions (e.g., prerequisite validation, approval handling, pipeline link display), so score 4 does not fit; the actions are concrete rather than generic, ruling out 2.

3 / 5

Completeness

It clearly answers 'what' ('Check release readiness and trigger the release pipeline for Azure SDK packages') and 'when' with explicit concrete trigger phrases in the USE FOR clause, mirroring the anchor-5 good example structure. Not 4, because the 'when' is fully explicit with quoted trigger phrases rather than merely serviceable.

5 / 5

Trigger Term Quality

USE FOR provides six natural phrases users would say ('release SDK', 'trigger release', 'check release readiness', 'release pipeline', 'publish package', 'ship SDK') with good DO NOT USE FOR boundaries. A few natural synonyms are missing (e.g., 'cut a release', 'roll out', 'go live'), so it falls short of comprehensive anchor 5 but is well above the partial-coverage anchor 3.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Azure SDK package release) with distinct triggers and an explicit DO NOT USE FOR list excluding adjacent domains ('SDK development, code generation, pipeline debugging, release plan creation'). Conflict risk is minimal; score 4's 'minor overlap risk' understates the explicit boundary guidance.

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/azsdk-common-sdk-release/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.