agent-framework-azure-ai-py

Build persistent agents on Azure AI Foundry using the Microsoft Agent Framework Python SDK.

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/agent-framework-azure-ai-py/SKILL.md

Quality

Content

72%Scale 1-3

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, highly actionable skill with executable code examples covering the full range of Azure AI Agent Framework capabilities. Its main weaknesses are the repetitive boilerplate across examples (hurting conciseness) and the absence of error handling, validation steps, or troubleshooting guidance for cloud service operations. The progressive disclosure and reference structure are excellent.

Suggestions

Factor out the repeated async context manager boilerplate (credential + provider setup) into a single 'common setup' section and reference it from subsequent examples to reduce redundancy.

Add error handling guidance or validation checkpoints—e.g., what to do when credential auth fails, how to verify agent creation succeeded, or how to handle rate limits from the Azure AI service.

Dimension	Reasoning	Score
Conciseness	The skill is fairly efficient but includes some redundancy—multiple examples repeat the same boilerplate (credential/provider setup) extensively, and the complete example at the end largely recombines earlier snippets. The architecture diagram and reference tables are lean, but the overall document could be tightened by factoring out repeated async context manager patterns.	2 / 3
Actionability	All code examples are fully executable, copy-paste ready Python with correct imports, async patterns, and concrete function definitions. The installation commands, environment variables, and authentication patterns are all specific and immediately usable.	3 / 3
Workflow Clarity	The skill presents clear individual patterns (basic agent, tools, streaming, threads, structured outputs) but lacks validation checkpoints or error handling guidance. There's no mention of what to do when agent creation fails, credential issues arise, or how to verify the agent was created successfully—important for cloud service operations.	2 / 3
Progressive Disclosure	The skill has a clear overview structure with well-organized sections progressing from basic to advanced, and explicitly references one-level-deep files (references/tools.md, references/mcp.md, etc.) for detailed topics. Navigation is straightforward with quick-reference tables.	3 / 3
	Total	10 / 12 Passed

Description

40%Scale 1-3

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

The description identifies a clear and distinctive technology niche (Azure AI Foundry + Microsoft Agent Framework Python SDK), which minimizes conflict risk. However, it is too terse—it lacks specific concrete actions beyond 'build persistent agents' and critically omits any 'Use when...' guidance, making it difficult for Claude to know when to select this skill from a large pool.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about building AI agents on Azure, using the Microsoft Agent Framework, or working with the azure-ai-projects Python package.'

List more specific actions such as 'configure agent tools (code interpreter, file search, Bing grounding), manage conversation threads, handle streaming responses, deploy and manage agent lifecycles.'

Include common user-facing trigger terms and variations like 'Azure agents', 'AI agent SDK', 'azure-ai-projects', 'agent tools', 'OpenAPI tools' to improve keyword coverage.

Dimension	Reasoning	Score
Specificity	Names the domain (Azure AI Foundry, Microsoft Agent Framework Python SDK) and a general action ('Build persistent agents'), but does not list multiple specific concrete actions like configuring tools, managing agent state, deploying endpoints, etc.	2 / 3
Completeness	Describes what it does ('Build persistent agents on Azure AI Foundry') but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2, and since the 'what' is also thin, this scores a 1.	1 / 3
Trigger Term Quality	Includes relevant keywords like 'Azure AI Foundry', 'Microsoft Agent Framework', 'Python SDK', and 'persistent agents', but misses common user variations such as 'Azure agents', 'AI agent', 'foundry agent', 'azure-ai-projects', or mentioning specific capabilities like tool use, file search, or code interpreter.	2 / 3
Distinctiveness Conflict Risk	The combination of 'Azure AI Foundry', 'Microsoft Agent Framework', and 'Python SDK' creates a very specific niche that is unlikely to conflict with other skills. This is a clearly distinct technology stack.	3 / 3
	Total	8 / 12 Passed

Validation

90%

Warnings & errors only

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

Validation — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: skills/agent-framework-azure-ai-py/SKILL.md
Commit: fbdfd63

Reviewed: about 7 hours ago

Table of Contents

Discovery Implementation Validation

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.