skill-creator
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.
67
51%
Does it follow best practices?
Impact
95%
2.06xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/skills/skill-creator/SKILL.mdEvaluation results
100%
75%Azure Service Bus Python Skill
Python Azure SDK skill authoring
Correct file location
100%
100%
Naming convention
0%
100%
Frontmatter trigger phrases
0%
100%
Section order: Installation before Env Vars
0%
100%
Section order: Auth before Core Workflow
40%
100%
Auth callout emoji present
0%
100%
Auth callout DefaultAzureCredential rule
0%
100%
Auth callout context manager rule
0%
100%
AZURE_TOKEN_CREDENTIALS env var
0%
100%
Context manager in code examples
50%
100%
No mixed sync/async
100%
100%
Best Practices sync/async item
25%
100%
Best Practices context manager item
25%
100%
No hardcoded credentials
28%
100%
Best Practices section exists
0%
100%
87%
12%Publish and Register the Cosmos DB Skill
Skill categorization and test setup
Symlink path correct
30%
100%
Symlink target correct
50%
100%
Symlink short name
0%
0%
acceptance-criteria.md location
100%
100%
scenarios.yaml location
100%
100%
Acceptance criteria correct/incorrect patterns
100%
100%
Acceptance criteria covers import paths
100%
100%
scenarios.yaml expected_patterns
100%
100%
scenarios.yaml forbidden_patterns
100%
100%
scenarios.yaml mock_response
100%
100%
README checklist completeness
100%
100%
README alphabetical order instruction
100%
100%
docs-site regeneration step
0%
0%
100%
60%Modernize the Form Recognizer Skill
Deprecated SDK skill migration
Migration notice present
100%
100%
Migration notice warns new projects
62%
100%
Both installation options shown
100%
100%
Legacy install labeled
100%
100%
Auth callout block added
0%
100%
DefaultAzureCredential shown as primary
0%
100%
API key demoted to Legacy subsection
0%
100%
AZURE_TOKEN_CREDENTIALS env var
0%
100%
Context manager in code
0%
100%
Best Practices sync/async item
0%
100%
Best Practices context manager item
0%
100%
migration-decision.md reasoning
100%
100%
- Repository
- microsoft/agent-skills
- Commit
325091f
- Evaluated
- Agent
- Claude Code
- Model
- Claude Sonnet 4.6
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.