azure-repos

name	azure-repos
description	Expert knowledge for Azure Repos development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Azure Repos Git/TFVC, branch/PR policies, repo permissions, CodeQL/secret scans, or TFVC migrations, and other Azure Repos related development tasks. Not for Azure DevOps (use azure-devops), Azure Pipelines (use azure-pipelines), Azure Boards (use azure-boards), Azure Artifacts (use azure-artifacts).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-19","generator":"docs2skills/1.0.0"}

Azure Repos Skill

This skill provides expert guidance for Azure Repos. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. 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

Category	Lines	Description
Troubleshooting	L36-L49	Diagnosing and fixing Git/TFVC issues in Azure Repos: index.lock, push/RPC errors, merge/lock conflicts, undo/recover changes, and troubleshooting CodeQL, dependency, and secret scanning.
Best Practices	L50-L65	Git and TFVC best practices: branching, pull requests, merges, large binaries, .gitignore, cross‑platform compatibility, repo health, and workspace cleanup/optimization.
Decision Making	L66-L74	Guidance on choosing and migrating version control in Azure Repos: Git vs TFVC, SVN/TFVC-to-Git migration strategies, mixed Git+TFVC use, and local vs server TFVC workspaces.
Architecture & Design Patterns	L75-L83	Designing and choosing TFVC branching structures/strategies, planning strategic branches, implementing feature isolation, and managing branches for DevOps workflows in Azure Repos.
Limits & Quotas	L84-L89	Repo size/branch/file limits in Azure Repos Git, and which languages/package managers are supported for GitHub Advanced Security dependency scanning.
Security	L90-L113	Securing Azure Repos and TFVC: auth methods (Entra, PAT, SSH, GCM), repo/branch/PR permissions and policies, branch locking, secure imports, and GitHub Advanced Security setup.
Configuration	L114-L144	Configuring Azure Repos/DevOps Git & TFVC: branch and PR policies, notifications, templates, repo settings, work item keywords, and security/scanning (CodeQL, secrets, dependencies).
Integrations & Coding Patterns	L145-L198	Integrating Azure Repos with tools (Functions, Node.js, IDEs, Slack/Teams, scanners) and automating workflows via TFVC/tf.exe and Git-specific commands and permissions.

Troubleshooting

Topic	URL
Handle Git index.lock issues in Visual Studio and Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/git-index-lock?view=azure-devops
Troubleshoot Git issues in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/howto?view=azure-devops
Troubleshoot and resolve Git merge conflicts in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/merging?view=azure-devops
Fix RPC failure errors when pushing to Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/rpc-failures-http-postbuffer?view=azure-devops
Undo and recover Git changes in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/undo?view=azure-devops
Troubleshoot CodeQL code scanning in Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/repos/security/github-advanced-security-code-scanning-troubleshoot?view=azure-devops
Troubleshoot dependency scanning in GitHub Advanced Security	https://learn.microsoft.com/en-us/azure/devops/repos/security/github-advanced-security-dependency-scanning-troubleshoot?view=azure-devops
Troubleshoot secret scanning issues in GitHub Advanced Security	https://learn.microsoft.com/en-us/azure/devops/repos/security/github-advanced-security-secret-scanning-troubleshoot?view=azure-devops
Resolve TFVC file and merge conflicts effectively	https://learn.microsoft.com/en-us/azure/devops/repos/tfvc/resolve-team-foundation-version-control-conflicts?view=azure-devops

Best Practices

Topic	URL
Complete, abandon, or revert Azure Repos pull requests	https://learn.microsoft.com/en-us/azure/devops/repos/git/complete-pull-requests?view=azure-devops
Adopt effective Git branching strategies in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/git-branching-guidance?view=azure-devops
Manage author names and emails for Azure Repos commits	https://learn.microsoft.com/en-us/azure/devops/repos/git/git-names?view=azure-devops
Configure Git ignore rules for Azure Repos projects	https://learn.microsoft.com/en-us/azure/devops/repos/git/ignore-files?view=azure-devops
Manage large binary files in Azure Repos Git	https://learn.microsoft.com/en-us/azure/devops/repos/git/manage-large-files?view=azure-devops
Choose merge strategies and use squash merges in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/merging-with-squash?view=azure-devops
Ensure cross-platform Git compatibility in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/os-compatibility?view=azure-devops
Remove large binaries from Azure Repos Git history	https://learn.microsoft.com/en-us/azure/devops/repos/git/remove-binaries?view=azure-devops
Maintain healthy Git repositories in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/repo-health?view=azure-devops
Review Azure Repos pull requests effectively	https://learn.microsoft.com/en-us/azure/devops/repos/git/review-pull-requests?view=azure-devops

Decision Making

Topic	URL
Plan and execute TFVC to Git migration in Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/repos/git/import-from-tfvc?view=azure-devops
Decide how to migrate from SVN to Git in Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/repos/git/perform-migration-from-svn-to-git?view=azure-devops
Use TFVC and Git together in one Azure DevOps project	https://learn.microsoft.com/en-us/azure/devops/repos/git/team-projects?view=azure-devops
Choose between Git and TFVC in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/tfvc/comparison-git-tfvc?view=azure-devops
Choose between local and server TFVC workspaces	https://learn.microsoft.com/en-us/azure/devops/repos/tfvc/decide-between-using-local-server-workspace?view=azure-devops

Architecture & Design Patterns

Topic	URL
Design TFVC branch structures for teams	https://learn.microsoft.com/en-us/azure/devops/repos/tfvc/branch-folders-files?view=azure-devops
Plan strategic branching in TFVC	https://learn.microsoft.com/en-us/azure/devops/repos/tfvc/branch-strategically?view=azure-devops
Choose effective TFVC branching strategies	https://learn.microsoft.com/en-us/azure/devops/repos/tfvc/branching-strategies-with-tfvc?view=azure-devops
Implement feature isolation strategy in TFVC	https://learn.microsoft.com/en-us/azure/devops/repos/tfvc/effective-feature-isolation-on-tfvc?view=azure-devops
Manage TFVC branching for DevOps workflows	https://learn.microsoft.com/en-us/azure/devops/repos/tfvc/effective-tfvc-branching-strategies-for-devops?view=azure-devops

Limits & Quotas

Topic	URL
Git repository limits and quotas in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/limits?view=azure-devops
Supported ecosystems for GitHub Advanced Security dependency scanning	https://learn.microsoft.com/en-us/azure/devops/repos/security/github-advanced-security-dependency-scanning-ecosystems?view=azure-devops

Security

Topic	URL
Manage Azure Repos pull requests and permissions	https://learn.microsoft.com/en-us/azure/devops/repos/git/about-pull-requests?view=azure-devops
Authenticate to Azure Repos Git with Entra, PAT, or SSH	https://learn.microsoft.com/en-us/azure/devops/repos/git/auth-overview?view=azure-devops
Set Azure Repos Git branch permissions and access	https://learn.microsoft.com/en-us/azure/devops/repos/git/branch-permissions?view=azure-devops
Configure Azure Repos Git branch policies securely	https://learn.microsoft.com/en-us/azure/devops/repos/git/branch-policies?view=azure-devops
Clone Azure Repos Git repositories with secure authentication	https://learn.microsoft.com/en-us/azure/devops/repos/git/clone?view=azure-devops
Secure Azure Repos SSH keys with passphrases	https://learn.microsoft.com/en-us/azure/devops/repos/git/gcm-ssh-passphrase?view=azure-devops
Securely import external Git repositories into Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/import-git-repository?view=azure-devops
Lock Azure Repos Git branches to prevent updates	https://learn.microsoft.com/en-us/azure/devops/repos/git/lock-branches?view=azure-devops
Enforce branch folder structure and secure auth in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/require-branch-folders?view=azure-devops
Configure Azure Repos Git repository permissions	https://learn.microsoft.com/en-us/azure/devops/repos/git/set-git-repository-permissions?view=azure-devops

Configuration

Topic	URL
Configure Azure Repos Git branch policies for code quality	https://learn.microsoft.com/en-us/azure/devops/repos/git/branch-policies-overview?view=azure-devops
Use Visual Studio Git commands and Azure DevOps integration	https://learn.microsoft.com/en-us/azure/devops/repos/git/command-prompt?view=azure-devops
Configure Git preferences and config files in Visual Studio	https://learn.microsoft.com/en-us/azure/devops/repos/git/git-config?view=azure-devops
Configure Azure Repos branch policy for external status services	https://learn.microsoft.com/en-us/azure/devops/repos/git/pr-status-policy?view=azure-devops
Configure Azure Repos pull request notification subscriptions	https://learn.microsoft.com/en-us/azure/devops/repos/git/pull-request-notifications?view=azure-devops
Configure custom pull request target branches in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/pull-request-targets?view=azure-devops
Configure pull request templates in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/pull-request-templates?view=azure-devops
Configure Azure Repos Git repository-level settings	https://learn.microsoft.com/en-us/azure/devops/repos/git/repository-settings?view=azure-devops
Configure commit message keywords to close Azure Boards work items	https://learn.microsoft.com/en-us/azure/devops/repos/git/resolution-mentions?view=azure-devops
Configure custom CodeQL queries in Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/repos/security/github-advanced-security-code-scanning-queries?view=azure-devops

Integrations & Coding Patterns

Topic	URL
Create Azure Functions-based custom branch policy for PRs	https://learn.microsoft.com/en-us/azure/devops/repos/git/create-pr-status-server-with-azure-functions?view=azure-devops
Build a Node.js pull request status server for Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/create-pr-status-server?view=azure-devops
Use Azure DevOps IntelliJ plugin with Git repositories	https://learn.microsoft.com/en-us/azure/devops/repos/git/create-repo-intellij?view=azure-devops
Authenticate Go install with Azure Repos Git	https://learn.microsoft.com/en-us/azure/devops/repos/git/go-install?view=azure-devops
Extend Azure Repos pull request workflow with status and policy	https://learn.microsoft.com/en-us/azure/devops/repos/git/pull-request-status?view=azure-devops
Use Azure CLI and Git to share code in Azure Repos	https://learn.microsoft.com/en-us/azure/devops/repos/git/share-your-code-in-git-cmdline?view=azure-devops
Share Eclipse projects to Azure Repos Git	https://learn.microsoft.com/en-us/azure/devops/repos/git/share-your-code-in-git-eclipse?view=azure-devops
Connect Xcode projects to Azure Repos with modern auth	https://learn.microsoft.com/en-us/azure/devops/repos/git/share-your-code-in-git-xcode?view=azure-devops
Connect Azure Repos notifications to Slack channels	https://learn.microsoft.com/en-us/azure/devops/repos/integrations/repos-slack?view=azure-devops
Monitor Azure Repos activity in Microsoft Teams