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.
66
51%
Does it follow best practices?
Impact
94%
1.74xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/skills/skill-creator/SKILL.mdPython Azure SDK skill structure and Best Practices
Correct file location
100%
100%
Naming convention
33%
100%
Frontmatter triggers
100%
100%
Section order: Installation before Authentication
100%
100%
Section order: Environment Variables present
100%
100%
AZURE_TOKEN_CREDENTIALS in env vars
0%
100%
Production credential guidance
0%
100%
Best Practices: sync/async consistency as item 1
0%
100%
Best Practices: context managers as item 2
0%
100%
Code examples use context managers
28%
100%
No sync/async interleaving
100%
100%
Symlink created
0%
0%
Acceptance criteria file
50%
100%
Scenarios YAML file
0%
100%
No hardcoded credentials
100%
100%
Rust Azure SDK skill authentication and crate usage
Official crate names
100%
100%
No DefaultAzureCredential in Rust
0%
100%
DeveloperToolsCredential for local dev
0%
100%
ManagedIdentityCredential for production
0%
100%
RequestContent::from() for uploads
0%
100%
RBAC role guidance
100%
100%
Rust Best Practices: credential item
0%
100%
Rust Best Practices: RequestContent item
0%
100%
Async-only acknowledgement
62%
100%
No hardcoded credentials
100%
100%
Deprecated SDK migration notice and dual installation
Migration notice present
83%
100%
Legacy installation option shown
100%
100%
Recommended installation option shown
62%
100%
Note that patterns apply to both packages
0%
37%
Cross-reference between skills
100%
40%
Explicit update-vs-create decision
100%
100%
Java DefaultAzureCredential usage
100%
100%
Java Builder pattern
100%
100%
Best Practices: sync/async consistency
100%
100%
Best Practices: context managers / resource cleanup
100%
100%
No hardcoded credentials
100%
100%
10cfecf
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.