Azure DevOps Skill

SkillDatabases & data

Expert knowledge for Azure DevOps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when managing agent pools, work item processes, analytics/OData reports, org limits, or Server deployments, and other Azure DevOps related development tasks. Not for Azure Boards (use azure-boards), Azure Pipelines (use azure-pipelines), Azure Repos (use azure-repos), Azure Test Plans (use azure-test-plans).

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Azure DevOps Skill skill

What this skill tells your AI

The instructions your AI receives, as published by microsoftdocs/agent-skills in skills/azure-devops/SKILL.md and read by ahel’s review.

This skill provides expert guidance for Azure DevOps. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
TroubleshootingL37-L54Diagnosing and fixing Azure DevOps issues: pools/MCP servers, performance, notifications/email, connectivity/permissions, wikis, dashboards/analytics, and server upgrades.
Best PracticesL55-L70Guidance on optimizing Azure DevOps performance, analytics, and reporting: pools, permissions, OData/Power BI queries, flow metrics, caches, and on-prem data cleanup.
Decision MakingL71-L88Guidance for architectural and migration decisions in Azure DevOps: agent pools, costs, org geography, auth, team structure, wikis, work tracking, analytics/reporting, and Server deployment/upgrade.
Architecture & Design PatternsL89-L99Architectural guidance for Azure DevOps/Server: pool architecture, reliability/DR, SQL/database dependencies, and design patterns for simple to complex multi-server topologies and analytics modeling.
Limits & QuotasL100-L115Limits, quotas, and naming rules for orgs/projects/work items, dashboards, wikis, pipelines, Managed DevOps Pools, plus data retention and Analytics availability.
SecurityL116-L173Configuring Azure DevOps and Azure DevOps Server security: identities, auth (Entra, OAuth), permissions/roles, groups, access levels, auditing, and secure service accounts/SSL.
ConfigurationL174-L250Configuring Azure DevOps/Server: pools, agents, networks, notifications, auditing, work item/process customization, analytics/dashboards, backups, services, SQL, and server administration settings.
Integrations & Coding PatternsL251-L294Integrating Azure DevOps with tools (VS, SIEM, notifications, clients) and building Analytics/OData- and Power BI–based reports for work items, pipelines, and test/requirements metrics.
DeploymentL295-L326Installing, configuring, scaling, moving, backing up, restoring, and upgrading Azure DevOps Server/TFS deployments, including SQL, SharePoint, domains, and project collections

Troubleshooting

TopicURL
Use diagnostic logs for Managed DevOps Pools troubleshootinghttps://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/diagnostics?view=azure-devops
Diagnose and fix Azure Managed DevOps Pools issueshttps://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/troubleshooting?view=azure-devops
Diagnose and fix remote Azure DevOps MCP Server issueshttps://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server-troubleshooting?view=azure-devops
Investigate Azure DevOps usage and performance issueshttps://learn.microsoft.com/en-us/azure/devops/organizations/accounts/usage-monitoring?view=azure-devops
Troubleshoot and configure Azure DevOps notificationshttps://learn.microsoft.com/en-us/azure/devops/organizations/notifications/faq-notifications?view=azure-devops
Diagnose and fix Azure DevOps notification email issueshttps://learn.microsoft.com/en-us/azure/devops/organizations/notifications/troubleshoot-not-getting-email?view=azure-devops
Use subscription logging to debug Azure DevOps notificationshttps://learn.microsoft.com/en-us/azure/devops/organizations/notifications/use-subscription-logging?view=azure-devops
Allowlist IPs and URLs for Azure DevOps connectivityhttps://learn.microsoft.com/en-us/azure/devops/organizations/security/allow-list-ip-url?view=azure-devops
Troubleshoot Azure DevOps access and permission issueshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/troubleshoot-permissions?view=azure-devops
Restore deleted Azure DevOps wikis using REST API and recycle binhttps://learn.microsoft.com/en-us/azure/devops/project/wiki/restore-deleted-wiki?view=azure-devops
Resolve common Azure DevOps dashboard and chart issueshttps://learn.microsoft.com/en-us/azure/devops/report/dashboards/faqs?view=azure-devops
Troubleshoot Azure DevOps Analytics views for Power BIhttps://learn.microsoft.com/en-us/azure/devops/report/powerbi/troubleshooting-views?view=azure-devops
Azure DevOps Server administration FAQ and support guidancehttps://learn.microsoft.com/en-us/azure/devops/server/faq?view=azure-devops-server
Troubleshoot Azure DevOps project collection upgrade failureshttps://learn.microsoft.com/en-us/azure/devops/server/troubleshooting/collection-upgrade-failure?view=azure-devops-server

Best Practices

TopicURL
Optimize Managed DevOps Pools cost and performancehttps://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/manage-costs?view=azure-devops
Optimize Azure DevOps permissions for large organizationshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/permission-performance-recommendations?view=azure-devops
Apply best practices when querying Azure DevOps Analyticshttps://learn.microsoft.com/en-us/azure/devops/report/analytics/analytics-best-practices?view=azure-devops
Choose and use Azure DevOps burndown and burnup chartshttps://learn.microsoft.com/en-us/azure/devops/report/dashboards/burndown-guidance?view=azure-devops
Use CFDs, cycle time, and lead time to improve flowhttps://learn.microsoft.com/en-us/azure/devops/report/dashboards/cumulative-flow-cycle-lead-time-guidance?view=azure-devops
Design efficient OData batch requests for Analyticshttps://learn.microsoft.com/en-us/azure/devops/report/extend-analytics/odata-batch?view=azure-devops
Optimize OData Analytics queries for performance limitshttps://learn.microsoft.com/en-us/azure/devops/report/extend-analytics/odata-query-guidelines?view=azure-devops
Add last refresh timestamp to Azure DevOps Power BI reportshttps://learn.microsoft.com/en-us/azure/devops/report/powerbi/add-last-refresh-time?view=azure-devops
Apply team-based filtering in Azure DevOps Power BI reportshttps://learn.microsoft.com/en-us/azure/devops/report/powerbi/create-team-filter?view=azure-devops
Add time-in-state DAX measures for Azure DevOps work itemshttps://learn.microsoft.com/en-us/azure/devops/report/powerbi/create-timeinstate-report?view=azure-devops
Refresh Azure DevOps client caches after maintenancehttps://learn.microsoft.com/en-us/azure/devops/server/admin/backup/refresh-data-caches?view=azure-devops-server
Clean up Azure DevOps Server data for performance and upgradeshttps://learn.microsoft.com/en-us/azure/devops/server/upgrade/clean-up-data?view=azure-devops-server

Decision Making

TopicURL
Choose between Managed DevOps Pools and VM scale-set agentshttps://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/migrate-from-scale-set-agents?view=azure-devops
Estimate and compare Managed DevOps Pools costshttps://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/pricing?view=azure-devops
Choose and manage Azure DevOps organization geographyhttps://learn.microsoft.com/en-us/azure/devops/organizations/accounts/change-organization-location?view=azure-devops
Migrate Azure DevOps public projects to GitHubhttps://learn.microsoft.com/en-us/azure/devops/organizations/projects/migrate-public-project?view=azure-devops
Plan for Azure DevOps public projects retirementhttps://learn.microsoft.com/en-us/azure/devops/organizations/projects/public-projects-retirement?view=azure-devops
Choose secure authentication methods for Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/authentication-guidance?view=azure-devops
Decide team structure and Agile tools in Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/organizations/settings/about-teams-and-settings?view=azure-devops
Choose between provisioned and code-published Azure DevOps wikishttps://learn.microsoft.com/en-us/azure/devops/project/wiki/provisioned-vs-published-wiki?view=azure-devops
Choose customization approaches for Azure DevOps work trackinghttps://learn.microsoft.com/en-us/azure/devops/reference/customize-work?view=azure-devops
Choose Azure DevOps Analytics query toolshttps://learn.microsoft.com/en-us/azure/devops/report/analytics/analytics-query-tools?view=azure-devops
Plan Azure DevOps reporting migration to Analyticshttps://learn.microsoft.com/en-us/azure/devops/report/powerbi/reporting-roadmap?view=azure-devops
Choose and plan Azure DevOps Server deployment topologyhttps://learn.microsoft.com/en-us/azure/devops/server/install/get-started?view=azure-devops-server
Understand Azure DevOps Server lifecycle and servicing optionshttps://learn.microsoft.com/en-us/azure/devops/server/install/servicing?view=azure-devops-server
Upgrade Azure DevOps Server Express or move to full Serverhttps://learn.microsoft.com/en-us/azure/devops/server/upgrade/express?view=azure-devops-server

Architecture & Design Patterns

TopicURL
Understand reliability and disaster recovery for Managed DevOps Poolshttps://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/reliability-managed-devops-pools?view=azure-devops
Model historical and trend data in Azure DevOps Analyticshttps://learn.microsoft.com/en-us/azure/devops/report/powerbi/analytics-historical-filtering?view=azure-devops
Understand Azure DevOps Server resource dependencieshttps://learn.microsoft.com/en-us/azure/devops/server/admin/app-dependencies?view=azure-devops-server
Plan complex multi-server Azure DevOps topologieshttps://learn.microsoft.com/en-us/azure/devops/server/architecture/examples-complex-topo?view=azure-devops-server
Design moderate Azure DevOps Server topologieshttps://learn.microsoft.com/en-us/azure/devops/server/architecture/examples-moderate-topo?view=azure-devops-server
Apply simple Azure DevOps Server topology patternshttps://learn.microsoft.com/en-us/azure/devops/server/architecture/examples-simple-topo?view=azure-devops-server
Understand Azure DevOps Server SQL database architecturehttps://learn.microsoft.com/en-us/azure/devops/server/architecture/sql-server-databases?view=azure-devops-server

Limits & Quotas

TopicURL
Understand quotas and VM SKUs for Managed DevOps Poolshttps://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/faq?view=azure-devops
Change Azure DevOps organization image within size limitshttps://learn.microsoft.com/en-us/azure/devops/organizations/accounts/change-organization-image?view=azure-devops
Delete Azure DevOps organization and data retentionhttps://learn.microsoft.com/en-us/azure/devops/organizations/accounts/delete-your-organization?view=azure-devops
Recover deleted Azure DevOps organizations within retention limitshttps://learn.microsoft.com/en-us/azure/devops/organizations/accounts/recover-your-organization?view=azure-devops
Rename Azure DevOps projects and notification behaviorhttps://learn.microsoft.com/en-us/azure/devops/organizations/projects/rename-project?view=azure-devops
Azure DevOps naming rules and restrictionshttps://learn.microsoft.com/en-us/azure/devops/organizations/settings/naming-restrictions?view=azure-devops
Review Azure DevOps work tracking object limitshttps://learn.microsoft.com/en-us/azure/devops/organizations/settings/work/object-limits?view=azure-devops
Configure and understand Azure DevOps wiki page follow notificationshttps://learn.microsoft.com/en-us/azure/devops/project/wiki/follow-notifications-wiki-pages?view=azure-devops
Add additional portfolio backlogs in Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/reference/add-portfolio-backlogs?view=azure-devops
Azure Pipelines ARM integration size limit changeshttps://learn.microsoft.com/en-us/azure/devops/release-notes/2023/sprint-225-update
Add and configure widgets on Azure DevOps dashboardshttps://learn.microsoft.com/en-us/azure/devops/report/dashboards/add-widget-to-dashboard?view=azure-devops
Understand Azure DevOps Analytics data availability by platformhttps://learn.microsoft.com/en-us/azure/devops/report/powerbi/data-available-in-analytics?view=azure-devops

Security

TopicURL
Configure managed identities for Managed DevOps Poolshttps://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-identity?view=azure-devops
Configure security for Azure Managed DevOps Poolshttps://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-security?view=azure-devops
Set Azure permissions for Managed DevOps Poolshttps://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/prerequisites?view=azure-devops
Configure Azure DevOps organization access security policieshttps://learn.microsoft.com/en-us/azure/devops/organizations/accounts/change-application-access-policies?view=azure-devops
Manage Azure DevOps organization ownership and permissionshttps://learn.microsoft.com/en-us/azure/devops/organizations/accounts/change-organization-ownership?view=azure-devops
Configure Azure DevOps access via Microsoft Entra IDhttps://learn.microsoft.com/en-us/azure/devops/organizations/accounts/faq-azure-access?view=azure-devops
Set up Visual Studio authentication with Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/organizations/accounts/faq-set-up-vs?view=azure-devops
Manage Azure DevOps users and permissions securelyhttps://learn.microsoft.com/en-us/azure/devops/organizations/accounts/faq-user-and-permissions-management?view=azure-devops
Enable and use Azure DevOps audit logging securelyhttps://learn.microsoft.com/en-us/azure/devops/organizations/audit/azure-devops-auditing?view=azure-devops
Manage security, permissions, and access in Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/?view=azure-devops
Azure DevOps authentication, authorization, and security policieshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/about-security-identity?view=azure-devops
Understand and configure Azure DevOps pipeline security roleshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/about-security-roles?view=azure-devops
Configure and manage Azure DevOps access levelshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/access-levels?view=azure-devops
Add Entra or AD groups to Azure DevOps security groupshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/add-ad-aad-built-in-security-groups?view=azure-devops
Manage Azure DevOps security groups and membershipshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/add-remove-manage-user-group-security-group?view=azure-devops
Add users and groups to Azure DevOps teams and projectshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/add-users-team-project?view=azure-devops
Change Azure DevOps Server user and group access levelshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/change-access-levels?view=azure-devops-server
Manage Azure DevOps organization and collection permissionshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/change-organization-collection-level-permissions?view=azure-devops
Change project-level permissions and group membershiphttps://learn.microsoft.com/en-us/azure/devops/organizations/security/change-project-level-permissions?view=azure-devops
Understand Azure DevOps data storage locations and movementhttps://learn.microsoft.com/en-us/azure/devops/organizations/security/data-location?view=azure-devops
Default Git repo and branch permissions in Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/default-git-permissions?view=azure-devops
Default TFVC repository permissions and constraintshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/default-tfvc-permissions?view=azure-devops
Download and interpret pipeline release permissions reporthttps://learn.microsoft.com/en-us/azure/devops/organizations/security/download-permissions-report-release?view=azure-devops
Download Azure DevOps repository permissions reporthttps://learn.microsoft.com/en-us/azure/devops/organizations/security/download-permissions-report?view=azure-devops
Export Azure DevOps users and access levelshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/export-users-audit-log?view=azure-devops
Use Stakeholder access securely in Azure Boardshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/get-started-stakeholder?view=azure-devops
Identify Azure DevOps Administrators via Microsoft Entrahttps://learn.microsoft.com/en-us/azure/devops/organizations/security/look-up-azure-devops-administrator?view=azure-devops
Find and manage Azure DevOps project administratorshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/look-up-project-administrators?view=azure-devops
Identify Project Collection Administrators in Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/look-up-project-collection-administrators?view=azure-devops
Request higher Azure DevOps permissions to resolve access errorshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/request-changes-permissions?view=azure-devops
Manage feature-level access control in Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/restrict-access?view=azure-devops
Restrict user invitation permissions in Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/restrict-invitations?view=azure-devops
Automate Azure DevOps security auditing with scriptshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/security-scripts?view=azure-devops
Configure object-level permissions in Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/set-object-level-permissions?view=azure-devops
Set permissions and access for Azure DevOps manual testinghttps://learn.microsoft.com/en-us/azure/devops/organizations/security/set-permissions-access-test?view=azure-devops
Set permissions for Azure DevOps work trackinghttps://learn.microsoft.com/en-us/azure/devops/organizations/security/set-permissions-access-work-tracking?view=azure-devops
Understand Azure DevOps Stakeholder access permissionshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/stakeholder-access?view=azure-devops
View and troubleshoot Azure DevOps effective permissionshttps://learn.microsoft.com/en-us/azure/devops/organizations/security/view-permissions?view=azure-devops
Manage Azure DevOps team administrator role assignmentshttps://learn.microsoft.com/en-us/azure/devops/organizations/settings/add-team-administrator?view=azure-devops
Configure OAuth service authorizations in Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/organizations/settings/manage-authorizations?view=azure-devops
Manage Azure DevOps wiki and README permissions via Git securityhttps://learn.microsoft.com/en-us/azure/devops/project/wiki/manage-readme-wiki-permissions?view=azure-devops
Configure permissions to access Azure DevOps Analyticshttps://learn.microsoft.com/en-us/azure/devops/report/analytics/analytics-permissions-prerequisites?view=azure-devops
Set Azure DevOps dashboard permissions for team membershttps://learn.microsoft.com/en-us/azure/devops/report/dashboards/dashboard-permissions?view=azure-devops
Configure Analytics permissions and security for Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/report/powerbi/analytics-security?view=azure-devops
Configure security and access for Azure DevOps analyticshttps://learn.microsoft.com/en-us/azure/devops/report/secure-your-analytics-reporting?view=azure-devops
Configure Azure DevOps Server service accounts securelyhttps://learn.microsoft.com/en-us/azure/devops/server/account-requirements?view=azure-devops-server
Add Azure DevOps Server administrators to built-in groupshttps://learn.microsoft.com/en-us/azure/devops/server/admin/add-administrator?view=azure-devops-server
Change SQL Reporting service account for Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/server/admin/change-service-account-or-password-sql-reporting?view=azure-devops-server
Change Azure DevOps Server service account credentialshttps://learn.microsoft.com/en-us/azure/devops/server/admin/change-service-account-password?view=azure-devops-server
Manage Azure DevOps Server services and service accountshttps://learn.microsoft.com/en-us/azure/devops/server/admin/service-accounts-dependencies?view=azure-devops
Set up Windows and AD groups for Azure DevOps Serverhttps://learn.microsoft.com/en-us/azure/devops/server/admin/setup-ad-groups?view=azure-devops-server
Configure HTTPS and SSL for Azure DevOps Serverhttps://learn.microsoft.com/en-us/azure/devops/server/admin/setup-secure-sockets-layer?view=azure-devops-server
Manage Azure DevOps groups and permissions with TFSSecurityhttps://learn.microsoft.com/en-us/azure/devops/server/command-line/tfssecurity-cmd?view=azure-devops-server
Assign SQL Reporting Services roles for Azure DevOpshttps://learn.microsoft.com/en-us/azure/devops/server/install/sql-server/reporting-services-roles?view=azure-devops-server

Shortened here. Read the whole file on GitHub.

Signals

GitHub stars
740
Forks
119
Last commit
Sep 2026

ahel review

  • S4info
    community integration — published by microsoftdocs, not azure

Automated review, not a security audit. Ruleset v1.

Advanced
Catalog kind
skill
Gateway key
azure-devops-microsoftdocs
Source
github.com/microsoftdocs/agent-skills