refactor: remove duplicate content from Foundry skill description

[anchenyi]

Summary

• Remove duplicated content from the Microsoft Foundry skill description.
• Clarify the hosted-agent workflow for existing projects and continued development.

[github-actions]

Details

# 🔍 Token Analysis Report

@github-copilot-for-azure/scripts@1.0.0 tokens
node --import tsx src/tokens/cli.ts compare --base origin/main --head HEAD --markdown

📊 Token Change Report

Comparing origin/main → HEAD

Summary

Metric	Value
📈 Total Change	+13 tokens (0%)
Before	14,099 tokens
After	14,112 tokens
Files Changed	2

Changed Files

File	Before	After	Change
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-hosted.md	7,598	7,617	+19 (0%)
plugins/azure-skills/skills/microsoft-foundry/SKILL.md	6,501	6,495	-6 (0%)

@github-copilot-for-azure/scripts@1.0.0 tokens
node --import tsx src/tokens/cli.ts check --markdown

📊 Token Limit Check Report

Checked: 850 files
Exceeded: 117 files

⚠️ Files Exceeding Token Limits

File	Tokens	Limit	Over By
.github/skills/analyze-comparison-tests/SKILL.md	579	500	+79
.github/skills/analyze-skill-issues/SKILL.md	2109	500	+1609
.github/skills/analyze-test-run/SKILL.md	2471	500	+1971
.github/skills/file-test-bug/SKILL.md	628	500	+128
.github/skills/sensei/SKILL.md	861	500	+361
.github/skills/skill-authoring/SKILL.md	839	500	+339
.github/skills/vally-eval/SKILL.md	1737	500	+1237
plugins/azure-kusto-graph-skills/skills/azure-kusto-graph/SKILL.md	4810	500	+4310
plugins/azure-kusto-graph-skills/skills/azure-kusto-irql/SKILL.md	2625	500	+2125
plugins/azure-kusto-graph-skills/skills/azure-kusto-irql-graph/SKILL.md	4781	500	+4281
plugins/azure-kusto-graph-skills/skills/azure-kusto-irql-graph/references/DEPLOY_IRQL_FUNCTIONS.md	2854	2000	+854
plugins/azure-skills/changelog-2026-07-24.md	4226	2000	+2226
plugins/azure-skills/skills/airunway-aks-setup/SKILL.md	1025	500	+525
plugins/azure-skills/skills/appinsights-instrumentation/SKILL.md	937	500	+437
plugins/azure-skills/skills/azure-ai/SKILL.md	820	500	+320
plugins/azure-skills/skills/azure-aigateway/SKILL.md	1261	500	+761
plugins/azure-skills/skills/azure-aigateway/references/policies.md	2342	2000	+342
plugins/azure-skills/skills/azure-app-onboard/SKILL.md	1623	500	+1123
plugins/azure-skills/skills/azure-app-onboard/deploy/SKILL.md	1816	500	+1316
plugins/azure-skills/skills/azure-app-onboard/deploy/references/code-deployment-container-apps.md	2140	2000	+140
plugins/azure-skills/skills/azure-app-onboard/deploy/references/deploy-checklist-template.md	2564	2000	+564
plugins/azure-skills/skills/azure-app-onboard/prepare/SKILL.md	1566	500	+1066
plugins/azure-skills/skills/azure-app-onboard/prepare/references/pricing-guide-services.md	2142	2000	+142
plugins/azure-skills/skills/azure-app-onboard/prepare/references/service-mapping.md	2022	2000	+22
plugins/azure-skills/skills/azure-app-onboard/prepare/references/sku-quota-validation.md	2278	2000	+278
plugins/azure-skills/skills/azure-app-onboard/references/session-protocol.md	2026	2000	+26
plugins/azure-skills/skills/azure-app-onboard/scaffold/SKILL.md	3592	500	+3092
plugins/azure-skills/skills/azure-app-onboard/scaffold/references/bicep-container-apps.md	2354	2000	+354
plugins/azure-skills/skills/azure-app-onboard/scaffold/references/self-review-checklist.md	2269	2000	+269
plugins/azure-skills/skills/azure-app-onboard/scaffold/references/subagent-iac-gen.md	2406	2000	+406
plugins/azure-skills/skills/azure-app-onboard-prereq/SKILL.md	2517	500	+2017
plugins/azure-skills/skills/azure-app-onboard-prereq/references/dependency-compatibility.md	2239	2000	+239
plugins/azure-skills/skills/azure-cloud-migrate/SKILL.md	1085	500	+585
plugins/azure-skills/skills/azure-cloud-migrate/references/services/container-apps/cloudrun-deployment-guide.md	2029	2000	+29
plugins/azure-skills/skills/azure-cloud-migrate/references/services/container-apps/deployment-guide.md	2458	2000	+458
plugins/azure-skills/skills/azure-cloud-migrate/references/services/container-apps/fargate-deployment-guide.md	2587	2000	+587
plugins/azure-skills/skills/azure-cloud-migrate/references/services/container-apps/spring-deployment-guide.md	3871	2000	+1871
plugins/azure-skills/skills/azure-cloud-migrate/references/services/functions/lambda-to-functions.md	2600	2000	+600
plugins/azure-skills/skills/azure-cloud-migrate/references/services/functions/runtimes/javascript.md	2181	2000	+181
plugins/azure-skills/skills/azure-compliance/SKILL.md	1188	500	+688
plugins/azure-skills/skills/azure-compute/SKILL.md	657	500	+157
plugins/azure-skills/skills/azure-compute/workflows/essential-machine-management/references/emm-enable-flow.md	2344	2000	+344
plugins/azure-skills/skills/azure-deploy/SKILL.md	1645	500	+1145
plugins/azure-skills/skills/azure-deploy/references/pre-deploy-checklist.md	4692	2000	+2692
plugins/azure-skills/skills/azure-deploy/references/recipes/azd/errors.md	4004	2000	+2004
plugins/azure-skills/skills/azure-deploy/references/troubleshooting.md	2038	2000	+38
plugins/azure-skills/skills/azure-diagnostics/SKILL.md	1596	500	+1096
plugins/azure-skills/skills/azure-enterprise-infra-planner/SKILL.md	911	500	+411
plugins/azure-skills/skills/azure-enterprise-infra-planner/references/constraints/compute-apps.md	2022	2000	+22
plugins/azure-skills/skills/azure-kubernetes/SKILL.md	2723	500	+2223
plugins/azure-skills/skills/azure-kubernetes/azure-kubernetes-automatic-readiness/SKILL.md	3690	500	+3190
plugins/azure-skills/skills/azure-kusto/SKILL.md	2152	500	+1652
plugins/azure-skills/skills/azure-messaging/SKILL.md	821	500	+321
plugins/azure-skills/skills/azure-prepare/SKILL.md	3145	500	+2645
plugins/azure-skills/skills/azure-prepare/references/aspire.md	4617	2000	+2617
plugins/azure-skills/skills/azure-prepare/references/plan-template.md	2560	2000	+560
plugins/azure-skills/skills/azure-prepare/references/recipes/azd/aspire.md	2275	2000	+275
plugins/azure-skills/skills/azure-prepare/references/recipes/azd/terraform.md	3555	2000	+1555
plugins/azure-skills/skills/azure-prepare/references/research.md	2196	2000	+196
plugins/azure-skills/skills/azure-prepare/references/resources-limits-quotas.md	3322	2000	+1322
plugins/azure-skills/skills/azure-prepare/references/security.md	2147	2000	+147
plugins/azure-skills/skills/azure-prepare/references/services/functions/bicep.md	3043	2000	+1043
plugins/azure-skills/skills/azure-prepare/references/services/functions/templates/recipes/composition.md	2813	2000	+813
plugins/azure-skills/skills/azure-prepare/references/services/functions/terraform.md	3404	2000	+1404
plugins/azure-skills/skills/azure-quotas/SKILL.md	3006	500	+2506
plugins/azure-skills/skills/azure-quotas/references/commands.md	2644	2000	+644
plugins/azure-skills/skills/azure-reliability/SKILL.md	5922	500	+5422
plugins/azure-skills/skills/azure-reliability/references/configure-multi-region.md	4729	2000	+2729
plugins/azure-skills/skills/azure-reliability/references/services/app-service/reliability.md	2591	2000	+591
plugins/azure-skills/skills/azure-resource-lookup/SKILL.md	1367	500	+867
plugins/azure-skills/skills/azure-resource-visualizer/SKILL.md	2122	500	+1622
plugins/azure-skills/skills/azure-storage/SKILL.md	1228	500	+728
plugins/azure-skills/skills/azure-upgrade/SKILL.md	1542	500	+1042
plugins/azure-skills/skills/azure-upgrade/references/languages/java/INSTRUCTION.md	2893	2000	+893
plugins/azure-skills/skills/azure-upgrade/references/languages/java/package-specific/com.microsoft.azure.management.md	2428	2000	+428
plugins/azure-skills/skills/azure-upgrade/references/languages/java/templates/PLAN_TEMPLATE.md	2411	2000	+411
plugins/azure-skills/skills/azure-upgrade/references/languages/java/templates/PROGRESS_TEMPLATE.md	2315	2000	+315
plugins/azure-skills/skills/azure-upgrade/references/languages/java/templates/SUMMARY_TEMPLATE.md	2190	2000	+190
plugins/azure-skills/skills/azure-upgrade/references/services/functions/automation.md	3463	2000	+1463
plugins/azure-skills/skills/azure-upgrade/references/services/functions/consumption-to-flex.md	2773	2000	+773
plugins/azure-skills/skills/azure-validate/SKILL.md	897	500	+397
plugins/azure-skills/skills/entra-agent-id/SKILL.md	3994	500	+3494
plugins/azure-skills/skills/entra-app-registration/SKILL.md	2058	500	+1558
plugins/azure-skills/skills/entra-app-registration/references/api-permissions.md	2545	2000	+545
plugins/azure-skills/skills/entra-app-registration/references/cli-commands.md	2211	2000	+211
plugins/azure-skills/skills/entra-app-registration/references/console-app-example.md	2752	2000	+752
plugins/azure-skills/skills/entra-app-registration/references/oauth-flows.md	2375	2000	+375
plugins/azure-skills/skills/microsoft-foundry/SKILL.md	6495	500	+5995
plugins/azure-skills/skills/microsoft-foundry/finetuning/SKILL.md	1376	500	+876
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/azd-guidance/references/azd-ai-cli.md	2230	2000	+230
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-hosted.md	7617	2000	+5617
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/quick-start-hosted.md	5635	2000	+3635
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/foundry-tool-catalog.md	10922	2000	+8922
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/local-run.md	2443	2000	+443
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/use-toolbox-in-hosted-agent.md	2643	2000	+643
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/deploy/deploy.md	5033	2000	+3033
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/eval-datasets/eval-datasets.md	2863	2000	+863
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/eval-datasets/references/generate-seed-dataset.md	2212	2000	+212
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/eval-datasets/references/trace-to-dataset.md	4325	2000	+2325
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/invocations-ws/invocations-ws.md	2652	2000	+652
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/observe.md	3856	2000	+1856
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/references/continuous-eval.md	3855	2000	+1855
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/references/evaluate-step.md	2175	2000	+175
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/references/evaluation-suite-generation.md	3134	2000	+1134
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/routine/routine.md	2032	2000	+32
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/trace/references/kql-templates.md	2701	2000	+701
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/SKILL.md	1798	500	+1298
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/capacity/SKILL.md	1739	500	+1239
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/customize/SKILL.md	2236	500	+1736
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/customize/references/customize-workflow.md	3336	2000	+1336
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/preset/SKILL.md	1227	500	+727
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/preset/references/preset-workflow.md	5539	2000	+3539
plugins/azure-skills/skills/microsoft-foundry/project/create/create-foundry-project.md	2287	2000	+287
plugins/azure-skills/skills/microsoft-foundry/quota/quota.md	2289	2000	+289
plugins/azure-skills/skills/microsoft-foundry/quota/references/capacity-planning.md	2081	2000	+81
plugins/azure-skills/skills/microsoft-foundry/references/agent-metadata-contract.md	2217	2000	+217
plugins/azure-skills/skills/python-appservice-deploy/SKILL.md	688	500	+188

Consider moving content to references/ subdirectories.

---

Automated token analysis. See skill authoring guidelines for best practices.

[Copilot]

Pull request overview

Refactors Microsoft Foundry skill routing metadata and clarifies hosted-agent project handling.

Changes:

• Refines skill description and trigger phrases.
• Clarifies existing-project and continued-development workflows.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Review findings
plugins/azure-skills/skills/microsoft-foundry/SKILL.md	Critical (1 vote): Generic Build trigger collides with azure-app-onboard. Nit (3 votes): Description exceeds the 60-word limit.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-hosted.md	Moderate (2 votes): Skipping project-selection steps can bypass unresolved or user-overridden project targets.

Suppressed comments (1)

plugins/azure-skills/skills/microsoft-foundry/SKILL.md:3

• The new opening sentence now qualifies models and resources as being managed "end to end with azd", but their referenced workflows do not use azd for those operations: model deployment is explicitly out-of-band via Azure CLI/MCP/portal, and resource creation's primary method is az cognitiveservices account create. Keep the with azd qualifier scoped to hosted-agent work, or state that models/resources use their dedicated workflows.

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

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

Suppressed comments (3)

plugins/azure-skills/skills/microsoft-foundry/SKILL.md:3

• This change advertises new routing/use cases for developing and updating an existing hosted agent, but the existing microsoft-foundry eval only covers the generic Build and deploy a Foundry agent prompt (evals/azure-skills/microsoft-foundry/eval.yaml:197-198). Add a Vally routing stimulus for an already-configured hosted project and continued development/update request so this newly advertised path is regression-tested.

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

plugins/azure-skills/skills/microsoft-foundry/SKILL.md:3

• Adding the standalone optimize trigger causes unrelated cost requests to match this skill. TriggerMatcher adds azure from the skill body and fires on any two substring matches, so optimize my Azure costs now matches optimize + azure and competes with azure-cost, whose description explicitly owns optimize costs. Remove the bare action token or express the trigger only through Foundry-specific terms (for example, Foundry prompt optimization).

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

plugins/azure-skills/skills/microsoft-foundry/SKILL.md:3

• The new introductory clause makes with azd govern agents, models, and resources, but the linked workflows are not all azd-based: model deployment explicitly uses Azure CLI/MCP for out-of-band projects, and resource, RBAC, and quota workflows use their own CLI/MCP paths. This can mislead non-azd requests; scope azd to hosted-agent work or name the supported tool paths.

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