diff --git a/skills/azure-devops-cli/SKILL.md b/skills/azure-devops-cli/SKILL.md
index a4a8fe58..c8e420fb 100644
--- a/skills/azure-devops-cli/SKILL.md
+++ b/skills/azure-devops-cli/SKILL.md
@@ -27,6 +27,7 @@ az extension add --name azure-devops
 az devops login --organization https://dev.azure.com/{org} --token YOUR_PAT_TOKEN
 
 # Set default organization and project (avoids repeating --org/--project)
+# Note: Legacy URL https://{org}.visualstudio.com should be replaced with https://dev.azure.com/{org}
 az devops configure --defaults organization=https://dev.azure.com/{org} project={project}
 
 # List current configuration