Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.
68
—
Does it follow best practices?
Impact
92%
2.29xAverage score across 1 eval scenario
Passed
No known issues
Python Azure SDK skill authoring
Frontmatter name field
100%
100%
Description trigger phrases
100%
100%
Section order: Installation before Env Vars
25%
100%
Section order: Auth before Core Workflow
50%
100%
Section order: Feature Tables before Best Practices
75%
100%
Auth callout 🔑 header
0%
100%
Auth callout rule 1: DefaultAzureCredential
0%
100%
Auth callout rule 2: context manager
0%
100%
Best Practices item 1: sync/async consistency
0%
100%
Best Practices item 2: context managers
25%
100%
Context manager in code examples
100%
100%
No sync/async mixing
100%
100%
AZURE_TOKEN_CREDENTIALS env var
0%
100%
microsoft-docs MCP search instruction
0%
0%
File under 500 lines
100%
100%
32cad4e
Table of Contents
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.