CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-ai

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.

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 ./.github/plugins/azure-skills/skills/azure-ai/SKILL.md

The canonical home for this skill is azure-ai in microsoft/GitHub-Copilot-for-Azure

SKILL.md
Quality
Evals
Security

Quality

Content

67%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 overview that routes cleanly to MCP tools, CLI commands, and a real set of SDK reference files. The main issues are moderate: two capability tables pad the body with knowledge Claude already has and duplicate the Services table, and the bundled auth guide is orphaned rather than linked.

Suggestions

Remove or merge the 'AI Search Capabilities' and 'Speech Capabilities' tables into the Services table — Claude already knows what full-text search, vector search, and neural text-to-speech are, and OCR/speech information currently appears in up to three places.

Add one example invocation per MCP tool (e.g., an azure__search search_query call with an index name and query payload) so the guidance is copy-paste ready for the common cases.

Link references/auth-best-practices.md from the body (e.g., a short 'Authentication' section) so the bundled file is discoverable, and note how to proceed when the user cannot or will not enable Azure MCP.

DimensionReasoningScore

Conciseness

The body is compact and table-based, but the 'AI Search Capabilities' and 'Speech Capabilities' tables restate concepts Claude already knows ("Full-text search — Linguistic analysis, stemming", "Vector search — Semantic similarity with embeddings", "Text-to-speech — Neural voices, SSML support"), and service information is repeated across the Services table, MCP section, and capability tables (OCR appears three times). This matches anchor 3, 'mostly efficient but includes some unnecessary explanation or could be tightened', rather than anchor 4 since two full sections could be cut.

3 / 5

Actionability

Concrete, executable guidance is present: exact MCP tool and command names ("azure__search with command search_index_list", "azure__speech with command speech_synthesize"), CLI commands ("az search", "az cognitiveservices"), and an explicit MCP-not-enabled fallback ("ask the user to run /mcp and enable Azure MCP"). It falls short of anchor 5 because there are no example invocations with arguments (e.g., a sample search_query payload or index name) and no CLI path at all for Speech and Document Intelligence.

4 / 5

Workflow Clarity

As a routing/reference skill the single action is largely unambiguous — prefer Azure MCP tools, with a clearly stated fallback when MCP is absent — and the operations involved are read-only so no validation cap applies. It sits at anchor 4 rather than 5 because the fallback path ends at 'ask the user to enable' with no guidance for proceeding (e.g., when the user declines or auth fails, and the bundle's auth-best-practices.md is never linked).

4 / 5

Progressive Disclosure

The body is a clear overview with well-signaled, one-level-deep references: all 14 SDK links (e.g., references/sdk/azure-search-documents-py.md) resolve to real files in references/sdk/, plus two external documentation links. However, scoring against the actual bundle, references/auth-best-practices.md exists but is never referenced anywhere in SKILL.md, making it undiscoverable — a minor organization gap that holds this at anchor 4 rather than anchor 5.

4 / 5

Total

15

/

20

Passed

Description

83%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 clearly states both what it does and when to use it, with a dense list of natural trigger terms and synonyms. Its main weaknesses are minor: two of four services are named without any actions, and a few common user phrases are absent from the trigger list.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR" — covering the named services. It sits at anchor 4 rather than 5 because the OpenAI and Document Intelligence services are named as domains only, with no accompanying actions ("Use for Azure AI: Search, Speech, OpenAI, Document Intelligence"), leaving minor coverage gaps.

4 / 5

Completeness

It explicitly answers both questions: the 'what' ("Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR.") and the 'when' with concrete trigger phrases ("WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech."). This matches anchor 5; anchor 4 would apply only if the WHEN guidance were less explicit.

5 / 5

Trigger Term Quality

The WHEN clause includes strong natural trigger phrasing with synonyms ("speech-to-text", "transcribe", "text-to-speech", "convert text to speech", "semantic search", "OCR"), but a few natural terms users would say are missing (e.g., "embeddings", "form extraction", "image analysis"), matching anchor 4's 'good coverage, a few natural terms missing' rather than anchor 5's comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

"Azure AI" with service names (AI Search, Speech, Document Intelligence) carves a clear niche, but generic triggers like "search", "transcribe", and "OCR" without an Azure qualifier create minor overlap risk with closely related document/PDF or AI skills — anchor 4 rather than anchor 5's 'minimal conflict risk'.

4 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 14 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 14 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

microsoft/azure-skills

Path

.github/plugins/azure-skills/skills/azure-ai/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.