CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

microsoft-foundry

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end. USE FOR: foundry, azd ai agent, azd provision/deploy, hosted agent scaffold/develop/run/deploy/troubleshoot, prompt agent, managed harness agent, Copilot harness, voice agent, create/update/invoke/evaluate agent, add tool to agent, agent insights, batch/continuous eval, continuous monitoring, agent CI/CD, optimize/improve prompt, optimize agent instructions, Agent Optimizer, dataset curation from traces, deploy model, model fine-tuning (SFT/DPO/RFT), Foundry project, RBAC, role assignment, permissions, quota, capacity, region, deployment failure, AI Services, create Foundry resource, knowledge index, customize deployment, onboard, availability, training-data, grader, distillation, large file upload. DO NOT USE FOR: Azure Functions, App Service, general Azure deploy (use azure-deploy), general Azure prep (use azure-prepare).

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Failed to scan

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

73%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered orchestration body: concrete commands and tables, rigorously ordered workflows with explicit validation and stop-and-ask gates, and a clean router structure delegating detail to sub-skills. Its weaknesses are repetitive boilerplate in the lifecycle tables and tip callouts, and a bundle in which most referenced sub-skill files are missing, breaking navigation.

Suggestions

State the mandatory '[dependency check and setup] → [azd-guidance]' preamble once as a blanket rule above the Agent Development Lifecycle table and drop the repeated prefix from each row, cutting substantial duplicated tokens.

Fold the four 💡 tip callouts (onboarding flow, fine-tuning, model deployment, prompt optimization) into the existing sub-skill table rows or a single tips section, since each duplicates routing already covered by the tables.

Ship or restore the 26 referenced sub-skill files (foundry-agent/*, project/*, models/deploy-model, quota, rbac, finetuning, resource/*) so the body's navigation links resolve, or inline minimal stub guidance for the most common workflows (create, deploy, invoke).

DimensionReasoningScore

Conciseness

The body is dense and mostly Foundry-specific (little Claude-already-knows explanation), but it could be meaningfully tightened: the Agent Development Lifecycle table repeats the same '[dependency check and setup] → [azd-guidance]' prefix in ~10 of its rows, and the four 💡 tip callouts restate routing already present in the sub-skill table. This matches 'mostly efficient but... could be tightened' rather than the 4 anchor's 'minor instances'.

3 / 5

Actionability

Mostly executable guidance: exact scripts ('./scripts/check-and-setup-dependencies.sh'), a copy-paste diagnostic command ('az cognitiveservices account show --query "properties.{...}"'), concrete azd variable tables, and an exact ordered classification procedure for azure.yaml services. Minor gaps remain — some directives are abstract ('Strictly follow the script output', 'Reference official Microsoft documentation URLs instead of embedding CLI command syntax') and no azure.yaml snippet is shown inline — so it does not reach fully copy-paste-ready coverage of common cases.

4 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with explicit checkpoints: Steps 1–7 of context resolution with ordered fallbacks and 'prompt the user to choose' rules; validation gates ('verify it matches the selected azd/metadata agent', 'verify with evaluator_catalog_get before treating them as remote evaluators', 'Persist... only after remote lookup or registration succeeds'); a conflict rule ('If azd and metadata both provide the same value and they differ, stop and ask'); and a full error-recovery flow for network isolation (symptom match → ambiguous-only confirmation command → routing). These are explicit validation steps, feedback loops, and checklists, matching the top anchor.

5 / 5

Progressive Disclosure

The SKILL.md is structured as a router: a sub-skill table, intent-to-workflow tables, and one-level-deep references to the three existing references/*.md files (agent-metadata-contract, auth-best-practices, standard-agent-setup) that all exist. However, 26 of the 29 referenced sub-skill .md paths (foundry-agent/*, project/*, models/*, quota, rbac, finetuning, resource/*) are absent from the provided bundle, so the primary navigation paths cannot be followed as shipped — 'easy navigation' is only partially verifiable, keeping this below the top anchor.

4 / 5

Total

16

/

20

Passed

Description

100%Weight 40%Scale 1-5

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

An exemplary skill description: a concrete, third-person capability statement, an exhaustive natural-language trigger list with synonyms, and an explicit negative boundary against adjacent Azure skills. The length is entirely functional trigger coverage rather than padding, with no fluff or over-claims.

DimensionReasoningScore

Specificity

The opening sentence lists six concrete actions ('Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end') covering the full capability surface of the domain, matching the top anchor for multiple specific concrete actions with comprehensive coverage; there is no vague filler to pull it toward 4.

5 / 5

Completeness

It explicitly answers 'what' ('Build, deploy, evaluate, optimize, fine-tune, and manage... end to end') and 'when' with a concrete trigger list plus an explicit negative boundary ('DO NOT USE FOR: Azure Functions, App Service, general Azure deploy (use azure-deploy)...'), exactly matching the anchor requiring both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

The 'USE FOR' clause enumerates natural user phrases with abundant synonyms and variations ('optimize/improve prompt, optimize agent instructions', 'RBAC, role assignment, permissions', 'model fine-tuning (SFT/DPO/RFT)', 'quota, capacity, region, deployment failure'), which is comprehensive natural-term coverage; the few product-internal terms ('knowledge index') sit alongside their natural counterparts, so this is not the 4 anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Microsoft Foundry specifically) and preemptively disambiguates the closest competing skills via the 'DO NOT USE FOR... (use azure-deploy) / (use azure-prepare)' carve-outs, giving distinct triggers and minimal conflict risk.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 59 missing, 56 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

microsoft/azure-skills

Path

.github/plugins/azure-skills/skills/microsoft-foundry/SKILL.md

Reviewed

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.