Optimize reference file utilization

As of May 6th 2026, based on the telemetry we have, these reference files exist but have 0 reference count. We should
- Automate tracking the unused reference files
- Investigate if any dead reference files should be cleaned up or updated to fix routing

A few skills are particularly problematic since they have been invoked but most of their reference files are never used:
- azure-cloud-migrate
- azure-compute
- azure-diagnostics
- azure-upgrade

These skills are never used and thus their reference files are never used.
- airunway-aks-setup
- azure-cost
- azure-kubernetes
- entra-agent-id

```
# Unused reference files (# unused / # total references)

airunway-aks-setup/references/gpu-profiles.md
airunway-aks-setup/references/model-sizing.md
airunway-aks-setup/references/powershell-notes.md
airunway-aks-setup/references/steps/step-1-verify.md
airunway-aks-setup/references/steps/step-2-controller.md
airunway-aks-setup/references/steps/step-3-gpu.md
airunway-aks-setup/references/steps/step-4-provider.md
airunway-aks-setup/references/steps/step-5-deploy.md
airunway-aks-setup/references/steps/step-6-summary.md
airunway-aks-setup/references/troubleshooting.md
10 / 10

appinsights-instrumentation/references/container-apps.md
1 / 11

azure-ai/references/sdk/azure-ai-contentsafety-java.md
azure-ai/references/sdk/azure-ai-contentsafety-ts.md
azure-ai/references/sdk/azure-ai-translation-ts.md
azure-ai/references/sdk/azure-ai-vision-imageanalysis-java.md
4 / 15

azure-aigateway/references/auth-best-practices.md
azure-aigateway/references/sdk/azure-ai-contentsafety-ts.md
azure-aigateway/references/sdk/azure-mgmt-apimanagement-dotnet.md
3 / 8

azure-cloud-migrate/references/services/app-service/app-engine-to-app-service.md
azure-cloud-migrate/references/services/app-service/assessment.md
azure-cloud-migrate/references/services/app-service/beanstalk-to-app-service.md
azure-cloud-migrate/references/services/app-service/code-migration.md
azure-cloud-migrate/references/services/app-service/global-rules.md
azure-cloud-migrate/references/services/app-service/heroku-to-app-service.md
azure-cloud-migrate/references/services/container-apps/assessment-guide.md
azure-cloud-migrate/references/services/container-apps/cloudrun-assessment-guide.md
azure-cloud-migrate/references/services/container-apps/cloudrun-deployment-guide.md
azure-cloud-migrate/references/services/container-apps/cloudrun-to-container-apps.md
azure-cloud-migrate/references/services/container-apps/deployment-guide.md
azure-cloud-migrate/references/services/container-apps/fargate-assessment-guide.md
azure-cloud-migrate/references/services/container-apps/fargate-deployment-guide.md
azure-cloud-migrate/references/services/container-apps/fargate-to-container-apps.md
azure-cloud-migrate/references/services/container-apps/k8s-to-container-apps.md
azure-cloud-migrate/references/services/container-apps/spring-apps-to-aca.md
azure-cloud-migrate/references/services/container-apps/spring-assessment-guide.md
azure-cloud-migrate/references/services/container-apps/spring-dependency-patterns.md
azure-cloud-migrate/references/services/container-apps/spring-deployment-guide.md
azure-cloud-migrate/references/services/functions/global-rules.md
azure-cloud-migrate/references/services/functions/runtimes/csharp.md
azure-cloud-migrate/references/services/functions/runtimes/java.md
azure-cloud-migrate/references/services/functions/runtimes/powershell.md
azure-cloud-migrate/references/services/functions/runtimes/typescript.md
azure-cloud-migrate/references/workflow-details.md
25 / 30

azure-compliance/references/auth-best-practices.md
azure-compliance/references/azqr-recommendations.md
azure-compliance/references/sdk/azure-keyvault-certificates-rust.md
azure-compliance/references/sdk/azure-keyvault-keys-rust.md
azure-compliance/references/sdk/azure-keyvault-keys-ts.md
azure-compliance/references/sdk/azure-keyvault-py.md
azure-compliance/references/sdk/azure-keyvault-secrets-rust.md
azure-compliance/references/sdk/azure-keyvault-secrets-ts.md
azure-compliance/references/sdk/azure-security-keyvault-keys-dotnet.md
azure-compliance/references/sdk/azure-security-keyvault-keys-java.md
azure-compliance/references/sdk/azure-security-keyvault-secrets-java.md
11 / 15

azure-compute/references/vm-quotas.md
azure-compute/workflows/capacity-reservation/capacity-reservation.md
azure-compute/workflows/capacity-reservation/references/association-disassociation.md
azure-compute/workflows/capacity-reservation/references/capacity-reservation-overview.md
azure-compute/workflows/essential-machine-management/essential-machine-management.md
azure-compute/workflows/essential-machine-management/references/emm-enable-flow-portal-guidance.md
azure-compute/workflows/essential-machine-management/references/emm-enable-flow.md
azure-compute/workflows/essential-machine-management/references/emm-overview.md
azure-compute/workflows/essential-machine-management/references/emm-prerequisites.md
azure-compute/workflows/vm-recommender/vm-recommender.md
azure-compute/workflows/vm-troubleshooter/references/cannot-connect-to-vm.md
azure-compute/workflows/vm-troubleshooter/references/credential-auth-errors.md
azure-compute/workflows/vm-troubleshooter/references/firewall-blocking.md
azure-compute/workflows/vm-troubleshooter/references/network-connectivity.md
azure-compute/workflows/vm-troubleshooter/references/rdp-connectivity.md
azure-compute/workflows/vm-troubleshooter/references/rdp-service-config.md
azure-compute/workflows/vm-troubleshooter/references/ssh-connectivity.md
azure-compute/workflows/vm-troubleshooter/references/vm-agent-not-responding.md
azure-compute/workflows/vm-troubleshooter/vm-troubleshooter.md
19 / 22

azure-cost/SKILL.md
azure-cost/cost-forecast/error-handling.md
azure-cost/cost-forecast/examples.md
azure-cost/cost-forecast/guardrails.md
azure-cost/cost-forecast/request-body-schema.md
azure-cost/cost-forecast/workflow.md
azure-cost/cost-optimization/auth-best-practices.md
azure-cost/cost-optimization/azure-aks-anomalies.md
azure-cost/cost-optimization/azure-aks-cost-addon.md
azure-cost/cost-optimization/azure-quick-review.md
azure-cost/cost-optimization/azure-resource-graph.md
azure-cost/cost-optimization/report-template.md
azure-cost/cost-optimization/sdk/azure-resource-manager-redis-dotnet.md
azure-cost/cost-optimization/services/redis/azure-cache-for-redis.md
azure-cost/cost-optimization/workflow.md
azure-cost/cost-query/dimensions-by-scope.md
azure-cost/cost-query/error-handling.md
azure-cost/cost-query/examples.md
azure-cost/cost-query/guardrails.md
azure-cost/cost-query/request-body-schema.md
azure-cost/cost-query/workflow.md
21 / 21

azure-deploy/references/live-role-verification.md
azure-deploy/references/recipes/azcli/errors.md
azure-deploy/references/recipes/azcli/verify.md
azure-deploy/references/recipes/azd/functions-deploy.md
azure-deploy/references/recipes/azd/scripts/apply-migrations.ps1
azure-deploy/references/recipes/azd/scripts/apply-migrations.sh
azure-deploy/references/recipes/azd/scripts/grant-and-migrate.ps1
azure-deploy/references/recipes/azd/scripts/grant-and-migrate.sh
azure-deploy/references/recipes/azd/sql-entra-auth.md
azure-deploy/references/recipes/azd/sql-managed-identity.md
azure-deploy/references/recipes/cicd/README.md
azure-deploy/references/recipes/cicd/errors.md
azure-deploy/references/recipes/cicd/examples/azdo-multistage.yml
azure-deploy/references/recipes/cicd/examples/github-azd.yml
azure-deploy/references/recipes/cicd/examples/github-bicep.yml
azure-deploy/references/recipes/cicd/verify.md
azure-deploy/references/recipes/terraform/errors.md
azure-deploy/references/recipes/terraform/verify.md
azure-deploy/references/region-availability.md
azure-deploy/references/sdk/azd-deployment.md
azure-deploy/references/sdk/azure-identity-dotnet.md
azure-deploy/references/sdk/azure-identity-java.md
azure-deploy/references/sdk/azure-identity-py.md
azure-deploy/references/sdk/azure-identity-ts.md
24 / 40

azure-diagnostics/SKILL.md
azure-diagnostics/references/app-service/README.md
azure-diagnostics/troubleshooting/aks/aks-troubleshooting.md
azure-diagnostics/troubleshooting/aks/general-diagnostics.md
azure-diagnostics/troubleshooting/aks/load-balancer-and-ingress.md
azure-diagnostics/troubleshooting/aks/network-policy.md
azure-diagnostics/troubleshooting/aks/networking.md
azure-diagnostics/troubleshooting/aks/node-issues.md
azure-diagnostics/troubleshooting/aks/pod-failures.md
azure-diagnostics/troubleshooting/aks/references/aks-mcp.md
azure-diagnostics/troubleshooting/aks/references/command-flows.md
azure-diagnostics/troubleshooting/aks/references/structured-input-modes.md
azure-diagnostics/troubleshooting/aks/spot-and-zone-issues.md
azure-diagnostics/troubleshooting/aks/upgrade-operations.md
azure-diagnostics/troubleshooting/messaging/README.md
azure-diagnostics/troubleshooting/messaging/auth-best-practices.md
azure-diagnostics/troubleshooting/messaging/azure-eventhubs-dotnet.md
azure-diagnostics/troubleshooting/messaging/azure-eventhubs-java.md
azure-diagnostics/troubleshooting/messaging/azure-eventhubs-js.md
azure-diagnostics/troubleshooting/messaging/azure-eventhubs-py.md
azure-diagnostics/troubleshooting/messaging/azure-servicebus-dotnet.md
azure-diagnostics/troubleshooting/messaging/azure-servicebus-java.md
azure-diagnostics/troubleshooting/messaging/azure-servicebus-js.md
azure-diagnostics/troubleshooting/messaging/azure-servicebus-py.md
azure-diagnostics/troubleshooting/messaging/service-troubleshooting.md
25 / 29

azure-enterprise-infra-planner/references/deployment.md
1 / 34

azure-kubernetes/azure-kubernetes-automatic-readiness/references/common-fixes.md
azure-kubernetes/azure-kubernetes-automatic-readiness/references/constraint-spec-v1.yaml
azure-kubernetes/azure-kubernetes-automatic-readiness/references/mcp-integration.md
azure-kubernetes/azure-kubernetes-automatic-readiness/references/migration-guide-summary.md
azure-kubernetes/references/azure-aks-autoscaler.md
azure-kubernetes/references/azure-aks-rightsizing.md
azure-kubernetes/references/azure-aks-spot.md
azure-kubernetes/references/azure-aks-vpa.md
azure-kubernetes/references/cli-reference.md
9 / 9

azure-prepare/references/functional-verification.md
azure-prepare/references/recipes/azcli/README.md
azure-prepare/references/recipes/azcli/commands.md
azure-prepare/references/recipes/azcli/scripts.md
azure-prepare/references/sdk/azure-appconfiguration-java.md
azure-prepare/references/sdk/azure-appconfiguration-py.md
azure-prepare/references/sdk/azure-appconfiguration-ts.md
azure-prepare/references/sdk/azure-identity-ts.md
azure-prepare/references/services/app-service/custom-domains.md
azure-prepare/references/services/app-service/deployment-slots.md
azure-prepare/references/services/app-service/networking.md
azure-prepare/references/services/app-service/scaling.md
azure-prepare/references/services/app-service/sku-selection.md
azure-prepare/references/services/app-service/templates/recipes/README.md
azure-prepare/references/services/app-service/templates/recipes/auth/README.md
azure-prepare/references/services/app-service/templates/recipes/auth/source/dotnet.md
azure-prepare/references/services/app-service/templates/recipes/auth/source/nodejs.md
azure-prepare/references/services/app-service/templates/recipes/auth/source/python.md
azure-prepare/references/services/app-service/templates/recipes/composition.md
azure-prepare/references/services/app-service/templates/recipes/cosmos/README.md
azure-prepare/references/services/app-service/templates/recipes/cosmos/source/dotnet.md
azure-prepare/references/services/app-service/templates/recipes/cosmos/source/nodejs.md
azure-prepare/references/services/app-service/templates/recipes/cosmos/source/python.md
azure-prepare/references/services/app-service/templates/recipes/redis/README.md
azure-prepare/references/services/app-service/templates/recipes/redis/source/dotnet.md
azure-prepare/references/services/app-service/templates/recipes/redis/source/nodejs.md
azure-prepare/references/services/app-service/templates/recipes/redis/source/python.md
azure-prepare/references/services/app-service/templates/recipes/sql/README.md
azure-prepare/references/services/app-service/templates/recipes/sql/source/dotnet.md
azure-prepare/references/services/app-service/templates/recipes/sql/source/nodejs.md
azure-prepare/references/services/app-service/templates/recipes/sql/source/python.md
azure-prepare/references/services/app-service/templates/selection.md
azure-prepare/references/services/app-service/templates/web-api.md
azure-prepare/references/services/app-service/templates/web-app.md
azure-prepare/references/services/container-apps/day2-operations.md
azure-prepare/references/services/container-apps/networking.md
azure-prepare/references/services/container-apps/revisions.md
azure-prepare/references/services/container-apps/terraform.md
azure-prepare/references/services/cosmos-db/bicep.md
azure-prepare/references/services/cosmos-db/partitioning.md
azure-prepare/references/services/cosmos-db/sdk.md
azure-prepare/references/services/durable-task-scheduler/README.md
azure-prepare/references/services/durable-task-scheduler/bicep.md
azure-prepare/references/services/durable-task-scheduler/dotnet.md
azure-prepare/references/services/durable-task-scheduler/java.md
azure-prepare/references/services/durable-task-scheduler/javascript.md
azure-prepare/references/services/event-grid/README.md
azure-prepare/references/services/event-grid/bicep.md
azure-prepare/references/services/event-grid/subscriptions.md
azure-prepare/references/services/functions/aspire-containerapps.md
azure-prepare/references/services/functions/templates/base/eval/summary.md
azure-prepare/references/services/functions/templates/base/eval/typescript.md
azure-prepare/references/services/functions/templates/recipes/README.md
azure-prepare/references/services/functions/templates/recipes/blob-eventgrid/eval/python.md
azure-prepare/references/services/functions/templates/recipes/blob-eventgrid/eval/summary.md
azure-prepare/references/services/functions/templates/recipes/common/dotnet-entry-point.md
azure-prepare/references/services/functions/templates/recipes/common/error-handling.md
azure-prepare/references/services/functions/templates/recipes/common/health-check.md
azure-prepare/references/services/functions/templates/recipes/common/nodejs-entry-point.md
azure-prepare/references/services/functions/templates/recipes/cosmosdb/eval/python.md
azure-prepare/references/services/functions/templates/recipes/cosmosdb/eval/summary.md
azure-prepare/references/services/functions/templates/recipes/cosmosdb/eval/typescript.md
azure-prepare/references/services/functions/templates/recipes/durable/README.md
azure-prepare/references/services/functions/templates/recipes/durable/eval/python.md
azure-prepare/references/services/functions/templates/recipes/durable/eval/summary.md
azure-prepare/references/services/functions/templates/recipes/eventhubs/README.md
azure-prepare/references/services/functions/templates/recipes/eventhubs/eval/python.md
azure-prepare/references/services/functions/templates/recipes/eventhubs/eval/summary.md
azure-prepare/references/services/functions/templates/recipes/mcp/eval/summary.md
azure-prepare/references/services/functions/templates/recipes/servicebus/README.md
azure-prepare/references/services/functions/templates/recipes/servicebus/eval/python.md
azure-prepare/references/services/functions/templates/recipes/servicebus/eval/summary.md
azure-prepare/references/services/functions/templates/recipes/servicebus/eval/typescript.md
azure-prepare/references/services/functions/templates/recipes/sql/eval/python.md
azure-prepare/references/services/functions/templates/recipes/sql/eval/summary.md
azure-prepare/references/services/functions/templates/recipes/timer/eval/python.md
azure-prepare/references/services/functions/templates/recipes/timer/eval/summary.md
azure-prepare/references/services/functions/terraform.md
azure-prepare/references/services/logic-apps/triggers.md
azure-prepare/references/services/service-bus/patterns.md
azure-prepare/references/services/sql-database/auth.md
azure-prepare/references/services/sql-database/bicep.md
azure-prepare/references/services/sql-database/scripts/grant-sql-access.ps1
azure-prepare/references/services/sql-database/scripts/grant-sql-access.sh
azure-prepare/references/services/sql-database/sdk.md
azure-prepare/references/services/static-web-apps/terraform.md
86 / 163

azure-storage/references/sdk/azure-data-tables-java.md
azure-storage/references/sdk/azure-storage-blob-rust.md
azure-storage/references/sdk/azure-storage-file-datalake-py.md
azure-storage/references/sdk/azure-storage-file-share-py.md
azure-storage/references/sdk/azure-storage-file-share-ts.md
azure-storage/references/sdk/azure-storage-queue-ts.md
6 / 13

azure-upgrade/references/languages/java/INSTRUCTION.md
azure-upgrade/references/languages/java/README.md
azure-upgrade/references/languages/java/bom-migration/bom-gradle-settings.md
azure-upgrade/references/languages/java/bom-migration/bom-gradle-toml.md
azure-upgrade/references/languages/java/bom-migration/bom-gradle.md
azure-upgrade/references/languages/java/bom-migration/bom-maven.md
azure-upgrade/references/languages/java/bom-migration/bom-migration.md
azure-upgrade/references/languages/java/bom-migration/bom-validation.md
azure-upgrade/references/languages/java/package-specific/com.microsoft.azure.eventprocessorhost.md
azure-upgrade/references/languages/java/package-specific/com.microsoft.azure.management.md
azure-upgrade/references/languages/java/rules/efficiency.md
azure-upgrade/references/languages/java/rules/execution-guidelines.md
azure-upgrade/references/languages/java/rules/review-code-changes.md
azure-upgrade/references/languages/java/rules/troubleshooting.md
azure-upgrade/references/languages/java/rules/upgrade-strategy.md
azure-upgrade/references/languages/java/rules/upgrade-success-criteria.md
azure-upgrade/references/languages/java/scripts/upgrade_bom.py
azure-upgrade/references/languages/java/templates/PLAN_TEMPLATE.md
azure-upgrade/references/languages/java/templates/PROGRESS_TEMPLATE.md
azure-upgrade/references/languages/java/templates/SUMMARY_TEMPLATE.md
azure-upgrade/references/languages/java/workflow/phase-1-precheck.md
azure-upgrade/references/languages/java/workflow/phase-2-plan.md
azure-upgrade/references/languages/java/workflow/phase-3-execute.md
azure-upgrade/references/languages/java/workflow/phase-4-summarize.md
azure-upgrade/references/services/redis/redis-to-amr.md
25 / 30

azure-validate/references/aspire-functions-secrets.md
azure-validate/references/recipes/azd/aspire.md
azure-validate/references/region-availability.md
azure-validate/references/role-verification.md
4 / 16

entra-agent-id/references/known-limitations.md
entra-agent-id/references/oauth2-token-flow.md
entra-agent-id/references/obo-blueprint-setup.md
entra-agent-id/references/runtime-token-exchange.md
entra-agent-id/references/sdk-sidecar-deployment.md
entra-agent-id/references/sdk-sidecar.md
6 / 6

entra-app-registration/references/sdk/azure-identity-java.md
entra-app-registration/references/sdk/azure-identity-rust.md
entra-app-registration/references/sdk/azure-keyvault-py.md
entra-app-registration/references/sdk/azure-keyvault-secrets-ts.md
4 / 16

microsoft-foundry/SKILL.md
microsoft-foundry/foundry-agent/create/references/toolbox.md
microsoft-foundry/foundry-agent/eval-datasets/references/dataset-organization.md
microsoft-foundry/foundry-agent/eval-datasets/references/dataset-versioning.md
microsoft-foundry/foundry-agent/eval-datasets/references/eval-lineage.md
microsoft-foundry/foundry-agent/eval-datasets/references/eval-regression.md
microsoft-foundry/foundry-agent/eval-datasets/references/eval-trending.md
microsoft-foundry/foundry-agent/eval-datasets/references/generate-seed-dataset.md
microsoft-foundry/foundry-agent/observe/references/continuous-eval.md
microsoft-foundry/models/deploy-model/SKILL.md
microsoft-foundry/models/deploy-model/capacity/SKILL.md
microsoft-foundry/models/deploy-model/customize/SKILL.md
microsoft-foundry/models/deploy-model/preset/SKILL.md
microsoft-foundry/quota/references/error-resolution.md
microsoft-foundry/quota/references/optimization.md
microsoft-foundry/resource/private-network/private-network.md
microsoft-foundry/resource/private-network/references/custom-template-adaptation.md
microsoft-foundry/resource/private-network/references/deploy.md
microsoft-foundry/resource/private-network/references/end-to-end-test.md
microsoft-foundry/resource/private-network/references/intake.md
microsoft-foundry/resource/private-network/references/post-deployment-validation.md
microsoft-foundry/resource/private-network/references/scaffold.md
microsoft-foundry/resource/private-network/references/template-index.md
microsoft-foundry/resource/private-network/references/vpn-dns-setup.bicep
microsoft-foundry/resource/private-network/references/vpn-dns-setup.md
25 / 75

```

No implementation files or tests are named; begin by reviewing the listed skill reference paths and the telemetry source that produced the unused counts. Determine the existing reference-loading or routing entry points, then define how automated tracking and cleanup or routing decisions will be verified as done.

Written by the indexing model from the issue text.