tessl install https://github.com/microsoft/agent-skills --skill foundry-sdk-pythongithub.com/microsoft/agent-skills
Build AI applications using the Azure AI Projects Python SDK (azure-ai-projects). Use when working with Foundry project clients, creating versioned agents with PromptAgentDefinition, running evaluations, managing connections/deployments/datasets/indexes, or using OpenAI-compatible clients. This is the high-level Foundry SDK - for low-level agent operations, use azure-ai-agents-python skill.
Average Score
98%
Content
100%
Description
100%
Generated
Validations
Total score
13/16| Criteria | Score |
|---|---|
skill_md_line_count SKILL.md line count is 291 (<= 500) | |
frontmatter_valid YAML frontmatter is valid | |
name_field 'name' field is valid: 'foundry-sdk-python' | |
description_field 'description' field is valid (393 chars) | |
description_voice 'description' uses third person voice | |
description_trigger_hint Description includes an explicit trigger hint | |
compatibility_field 'compatibility' field not present (optional) | |
allowed_tools_field 'allowed-tools' field not present (optional) | |
metadata_version 'metadata' field is not a dictionary | |
metadata_field 'metadata' field not present (optional) | |
license_field 'license' field is missing | |
frontmatter_unknown_keys No unknown frontmatter keys found | |
body_present SKILL.md body is present | |
body_examples Examples detected (code fence or 'Example' wording) | |
body_output_format No obvious output/return/format terms detected; consider specifying expected outputs | |
body_steps Step-by-step structure detected (ordered list) |
Content
Total score
12/12| Dimension | Score |
|---|---|
conciseness The content is lean and efficient, providing code examples without explaining basic concepts Claude already knows. Every section delivers actionable information without padding or unnecessary context. | 3/3 |
actionability All code examples are fully executable and copy-paste ready with proper imports, environment variable usage, and complete method calls. The tables provide quick reference for operations and tools. | 3/3 |
workflow_clarity The Thread and Message Flow section provides a clear numbered sequence with status checking before proceeding. The best practices section reinforces proper patterns like cleanup and context managers. | 3/3 |
progressive_disclosure Excellent structure with a comprehensive overview in the main file and clear one-level-deep references to detailed documentation (references/agents.md, references/tools.md, etc.). Each section provides enough to get started while pointing to deeper resources. | 3/3 |
Overall Assessment
This is an exemplary skill file that demonstrates excellent technical documentation practices. It provides comprehensive coverage of the Azure AI Projects SDK with executable code examples, clear organization through tables and sections, and appropriate progressive disclosure to reference files. The SDK comparison table is particularly valuable for helping users choose the right tool.
Description
Total score
12/12| Dimension | Score |
|---|---|
specificity Lists multiple specific concrete actions: 'creating versioned agents with PromptAgentDefinition, running evaluations, managing connections/deployments/datasets/indexes, using OpenAI-compatible clients'. These are precise, actionable capabilities. | 3/3 |
completeness Clearly answers both what ('Build AI applications using the Azure AI Projects Python SDK') and when ('Use when working with Foundry project clients, creating versioned agents...'). Includes explicit 'Use when' clause with specific trigger scenarios. | 3/3 |
trigger_term_quality Includes natural keywords users would say: 'Azure AI Projects', 'Python SDK', 'azure-ai-projects', 'Foundry', 'agents', 'PromptAgentDefinition', 'evaluations', 'connections', 'deployments', 'datasets', 'indexes', 'OpenAI-compatible'. Good coverage of technical terms users would naturally use. | 3/3 |
distinctiveness_conflict_risk Highly distinctive with clear niche: explicitly names the SDK package 'azure-ai-projects', distinguishes itself from the related 'azure-ai-agents-python skill' for low-level operations. Clear boundary between high-level Foundry SDK and low-level agent operations. | 3/3 |
Overall Assessment
This is an excellent skill description that hits all the marks. It provides specific concrete actions, includes natural trigger terms users would search for, explicitly states both what it does and when to use it, and clearly distinguishes itself from a related skill. The explicit differentiation from the azure-ai-agents-python skill is particularly valuable for avoiding conflicts.