chore: clean out-of-date descriptions in foundry skill

[anchenyi]

Description

Clean out-of-date descriptions, leftover starter guidance, and unused reference docs in the microsoft-foundry skill

Changes

• Replace descriptive Azure AI Foundry / AI Foundry with Microsoft Foundry across skill docs, scripts, tests, and evals
• Drop leftover azd-ai-starter-basic guidance
• Remove unused foundry-agent/create/references/agentframework.md
• Clarify create vs quick-start routing
• After local invoke succeeds, ask before deploy instead of deploying silently
• For continue-development on an existing Foundry hosted agent, browse azd ai agent sample list for Foundry-specific feature references
• Document MCP agent 403 Forbidden as insufficient RBAC (Foundry User on the project)

Checklist

• Tests pass locally (cd tests && npm test)
• Title has one of the prefixes: fix:, feat:, feature:, chore:, misc:, test:, eval:
• If modifying skill descriptions: verified routing correctness with integration tests (In tests/, npm run test:integration -- <skill> or npm run test:vally -- --skill <skill>)

Related Issues

[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	-1,130 tokens (-2%)
Before	57,010 tokens
After	55,880 tokens
Files Changed	19

Changed Files

File	Before	After	Change
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/agentframework.md	1,213	-	-1213
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-prompt.md	1,028	1,056	+28 (+3%)
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-hosted.md	7,368	7,395	+27 (0%)
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/quick-start-hosted.md	4,986	4,993	+7 (0%)
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/SKILL.md	1,805	1,798	-7 (0%)
plugins/azure-skills/skills/microsoft-foundry/SKILL.md	6,488	6,494	+6 (0%)
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/preset/references/preset-workflow.md	5,534	5,539	+5 (0%)
plugins/azure-skills/skills/microsoft-foundry/project/create/create-foundry-project.md	2,283	2,287	+4 (0%)
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/troubleshoot/troubleshoot.md	1,637	1,639	+2 (0%)
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/preset/EXAMPLES.md	733	735	+2 (0%)
plugins/azure-skills/skills/microsoft-foundry/finetuning/SKILL.md	1,375	1,376	+1 (0%)
plugins/azure-skills/skills/microsoft-foundry/finetuning/references/training-types.md	747	748	+1 (0%)
plugins/azure-skills/skills/microsoft-foundry/finetuning/workflows/quickstart.md	1,147	1,148	+1 (0%)
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/references/cicd-monitoring.md	919	920	+1 (0%)
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/customize/SKILL.md	2,235	2,236	+1 (0%)
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/customize/references/customize-workflow.md	3,335	3,336	+1 (0%)
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/preset/SKILL.md	1,226	1,227	+1 (0%)
plugins/azure-skills/skills/microsoft-foundry/quota/quota.md	2,288	2,289	+1 (0%)
plugins/azure-skills/skills/microsoft-foundry/quota/references/capacity-planning.md	2,080	2,081	+1 (0%)

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

📊 Token Limit Check Report

Checked: 820 files
Exceeded: 113 files

⚠️ Files Exceeding Token Limits

File	Tokens	Limit	Over By
.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-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	1622	500	+1122
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	2634	500	+2134
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	6494	500	+5994
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	2125	2000	+125
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-hosted.md	7395	2000	+5395
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/quick-start-hosted.md	4993	2000	+2993
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	2252	2000	+252
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	4897	2000	+2897
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/microsoft-foundry/references/sdk/foundry-sdk-py.md	2167	2000	+167
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

Updates the microsoft-foundry skill package to remove outdated guidance and consistently use “Microsoft Foundry” naming across skill docs, scripts, tests, and eval prompts (while keeping URL/ARM identifiers intact).

Changes:

• Renamed “Azure AI Foundry”/“AI Foundry” wording to “Microsoft Foundry” across skill documentation, scripts, trigger tests, integration tests, and eval stimuli.
• Removed unused/out-of-date reference docs (SDK quick reference + Agent Framework reference).
• Refined hosted-agent create/quick-start wording (capture manifestUrl, and ask before deploying after local invoke succeeds).

Reviewed changes

Copilot reviewed 43 out of 43 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
tests/microsoft-foundry/triggers.test.ts	Updates trigger prompts to use “Microsoft Foundry” terminology.
tests/microsoft-foundry/resource/create/triggers.test.ts	Updates resource/create trigger prompt wording.
tests/microsoft-foundry/quota/integration.test.ts	Updates quota integration prompts to “Microsoft Foundry.”
tests/microsoft-foundry/integration.test.ts	Updates RBAC-related integration prompt naming.
tests/microsoft-foundry/foundry-agent/observe/triggers.test.ts	Updates observe trigger prompt naming.
tests/microsoft-foundry/foundry-agent/eval-datasets/triggers.test.ts	Updates eval-datasets trigger prompt naming.
tests/microsoft-foundry/finetuning/triggers.test.ts	Updates finetuning trigger prompt naming.
plugins/azure-skills/skills/microsoft-foundry/SKILL.md	Updates sub-skill table wording, project endpoint wording, and removes SDK quick reference link.
plugins/azure-skills/skills/microsoft-foundry/references/standard-agent-setup.md	Renames overview wording to “Microsoft Foundry.”
plugins/azure-skills/skills/microsoft-foundry/references/sdk/foundry-sdk-py.md	Removes unused Python SDK reference doc.
plugins/azure-skills/skills/microsoft-foundry/rbac/rbac.md	Updates additional-resources link text to “Microsoft Foundry.”
plugins/azure-skills/skills/microsoft-foundry/quota/references/optimization.md	Renames quota optimization intro wording.
plugins/azure-skills/skills/microsoft-foundry/quota/references/capacity-planning.md	Renames capacity-planning wording and portal references.
plugins/azure-skills/skills/microsoft-foundry/quota/quota.md	Renames PTU calculator label to “Microsoft Foundry.”
plugins/azure-skills/skills/microsoft-foundry/project/create/create-foundry-project.md	Renames project/create frontmatter + headings + resource list portal naming.
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/SKILL.md	Renames prerequisite wording for project resource ID.
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/scripts/generate_deployment_url.sh	Renames portal wording in script header/usage text.
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/scripts/generate_deployment_url.ps1	Renames portal wording in script comments.
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/preset/SKILL.md	Renames prerequisite wording + portal location + parent-skill description.
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/preset/references/preset-workflow.md	Renames user-facing workflow strings to “Microsoft Foundry.”
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/preset/EXAMPLES.md	Renames example scenario wording.
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/customize/SKILL.md	Renames prerequisite wording + parent-skill description.
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/customize/references/customize-workflow.md	Renames success-output wording to “Microsoft Foundry portal link.”
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/capacity/scripts/discover_and_rank.ps1	Renames comment describing project query scope.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/troubleshoot/troubleshoot.md	Renames “project endpoint” wording.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/references/evaluate-step.md	Renames evaluation reference link text.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/references/cicd-monitoring.md	Renames evaluation reference link text.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/agentframework.md	Removes unused Agent Framework reference doc.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/quick-start-hosted.md	Adjusts quick-start sample guidance and asks before deploy after local invoke success.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-prompt.md	Documents 403 Forbidden as an RBAC/role issue for MCP agent operations.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-hosted.md	Adds guidance to browse azd ai agent sample list for feature references on existing hosted agents.
plugins/azure-skills/skills/microsoft-foundry/finetuning/workflows/quickstart.md	Renames prerequisites + portal wording for fine-tuning quickstart.
plugins/azure-skills/skills/microsoft-foundry/finetuning/workflows/full-pipeline.md	Renames full-pipeline intro/prereq wording.
plugins/azure-skills/skills/microsoft-foundry/finetuning/SKILL.md	Renames frontmatter description and heading to “Microsoft Foundry.”
plugins/azure-skills/skills/microsoft-foundry/finetuning/scripts/validate/validate_sft.py	Renames docstring target product wording.
plugins/azure-skills/skills/microsoft-foundry/finetuning/scripts/validate/validate_rft.py	Renames docstrings + argparse description wording.
plugins/azure-skills/skills/microsoft-foundry/finetuning/scripts/validate/validate_dpo.py	Renames docstring target product wording.
plugins/azure-skills/skills/microsoft-foundry/finetuning/scripts/submit_training.py	Renames module/help text to “Microsoft Foundry.”
plugins/azure-skills/skills/microsoft-foundry/finetuning/scripts/deploy_model.py	Renames module/help text to “Microsoft Foundry.”
plugins/azure-skills/skills/microsoft-foundry/finetuning/scripts/common.py	Renames module docstring and upload helper docstring wording.
plugins/azure-skills/skills/microsoft-foundry/finetuning/references/training-types.md	Renames model-compatibility section wording + portal wording.
plugins/azure-skills/skills/microsoft-foundry/finetuning/references/agentic-rft.md	Renames access note to “Microsoft Foundry portal.”
evals/azure-skills/microsoft-foundry/eval.yaml	Updates eval stimuli prompts to “Microsoft Foundry.”

[Copilot]

Pull request overview

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

Suppressed comments (2)

plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/scripts/generate_deployment_url.sh:3

• This script still uses a hardcoded shebang (#!/bin/bash). Other bash scripts in this skill use #!/usr/bin/env bash (e.g., plugins/azure-skills/skills/microsoft-foundry/scripts/check-and-setup-dependencies.sh:1), which is more portable and aligns with the repo’s bash-script guidance.

#!/bin/bash
# Generate Microsoft Foundry portal URL for a model deployment
# This script creates a direct clickable link to view a deployment in the Microsoft Foundry portal

tests/microsoft-foundry/resource/create/triggers.test.ts:36

• This resource/create trigger list still includes an azd ai starter basic prompt, which conflicts with the PR goal to drop leftover starter guidance and is also not a resource-creation scenario (it’s project scaffolding). Consider replacing it with a resource-focused prompt so this test stays scoped to resource creation triggers.