CtrlK
BlogDocsLog inGet started
Tessl Logo

microsoft-docs

Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. USE FOR: Azure service overviews, quickstarts, configuration guides, limits and quotas, best practices, architecture patterns, WAF pillar references. DO NOT USE FOR: code sample lookups (use microsoft-code-reference), skill creation (use microsoft-skill-creator), Azure pricing (use azure-pricing MCP).

89

Quality

86%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that clearly defines its purpose, provides comprehensive trigger terms, and explicitly delineates boundaries with related skills. The USE FOR / DO NOT USE FOR structure is particularly effective for disambiguation in a multi-skill environment. The description uses proper third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'understand concepts, find tutorials, learn how services work' plus detailed use cases like 'service overviews, quickstarts, configuration guides, limits and quotas, best practices, architecture patterns, WAF pillar references.'

3 / 3

Completeness

Clearly answers both 'what' (query official Microsoft documentation to understand concepts, find tutorials, learn how services work) and 'when' (USE FOR clause with explicit triggers, plus DO NOT USE FOR clause that further clarifies boundaries and redirects to other skills).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'Azure service overviews', 'quickstarts', 'configuration guides', 'limits and quotas', 'best practices', 'architecture patterns', 'Microsoft documentation'. These are terms users naturally use when seeking Azure documentation help.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with explicit boundary-setting via the DO NOT USE FOR clause, which names specific alternative skills for code samples, skill creation, and pricing. This dramatically reduces conflict risk with neighboring skills.

3 / 3

Total

12

/

12

Passed

Implementation

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured skill that provides actionable guidance for querying Microsoft documentation, with good concrete examples of effective queries and a useful CLI fallback section. Its main weaknesses are minor verbosity (the 'Why Use This' section adds little value for Claude) and the implicit rather than explicit search-then-fetch workflow. Overall it's a solid, practical skill.

Suggestions

Remove the 'Why Use This' section — Claude doesn't need to be convinced of the value of official documentation over training data.

Add an explicit mini-workflow: '1. Search with specific query → 2. Review excerpts → 3. Fetch full page if excerpts are insufficient' to make the two-step process unambiguous.

DimensionReasoningScore

Conciseness

Mostly efficient but includes some unnecessary sections like 'Why Use This' which explains obvious benefits (accuracy, authority) that Claude already understands. The 'When to Use' examples are helpful but slightly verbose.

2 / 3

Actionability

Provides concrete tool names, specific query examples (good vs bad), executable CLI commands with install instructions, and a clear mapping table between MCP tools and CLI alternatives. Copy-paste ready.

3 / 3

Workflow Clarity

The search-then-fetch workflow is implied through the 'When to Fetch Full Page' section but lacks an explicit sequenced workflow (e.g., 1. Search first, 2. Evaluate excerpts, 3. Fetch if needed). For a relatively simple two-tool skill this is adequate but could be clearer.

2 / 3

Progressive Disclosure

For a skill under 50 lines with no need for external references, the content is well-organized into clear sections with logical groupings (tools, when to use, query tips, fetch guidance, CLI fallback). Navigation is straightforward.

3 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jonathan-vella/azure-agentic-infraops
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.