Microsoftdocs Agent Skills
Microsoft Docs avatar
Microsoft Docs

Azure Artifacts

Skill

Expert knowledge for Azure Artifacts development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when managing feeds, upstream sources, views, .npmrc auth, .artifactignore, or GitHub Actions package publishing, and other Azure Artifacts related development tasks. Not for Azure DevOps (use azure-devops), Azure Pipelines (use azure-pipelines), Azure Repos (use azure-repos), Azure Boards (use azure-boards).

Source: /skills/azure-artifacts/SKILL.md

Azure Artifacts Skill

This skill provides expert guidance for Azure Artifacts. Covers troubleshooting, best practices, decision making, 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

Category Lines Description
Troubleshooting L36-L40 Diagnosing and resolving common Azure Artifacts problems, including feed access issues, authentication/permissions errors, package publishing/restore failures, and client tooling misconfigurations.
Best Practices L41-L47 Best practices for secure, reliable Azure Artifacts package management, including configuring and using upstream sources safely and restoring packages from them.
Decision Making L48-L54 Guidance on planning and choosing Azure Artifacts feeds (project vs org scope) and migration paths from file shares or MyGet to Azure Artifacts.
Limits & Quotas L55-L62 Storage, size, count, and retention limits for Azure Artifacts packages, plus how to monitor usage, configure deletion/retention, and publish universal packages within quota constraints.
Security L63-L68 Securing Azure Artifacts feeds: configuring upstream source protections against malicious packages and managing feed/view permissions and access control.
Configuration L69-L76 Configuring Azure Artifacts feeds: views, upstream sources, npm .npmrc auth/settings, and .artifactignore for optimizing Azure Pipelines artifact behavior and performance.
Integrations & Coding Patterns L77-L116 How to connect build tools (Cargo, Maven, Gradle, npm, NuGet, Python, PowerShell) to Azure Artifacts feeds, publish/restore packages, use upstream sources, and debug with symbols
Deployment L117-L120 Using GitHub Actions to build and push packages (NuGet, npm, etc.) to Azure Artifacts feeds, including workflow setup, authentication, and CI/CD integration.

Troubleshooting

Topic URL
Diagnose and fix common Azure Artifacts issues https://learn.microsoft.com/en-us/azure/devops/artifacts/troubleshooting?view=azure-devops

Best Practices

Topic URL
Apply Azure Artifacts package management best practices https://learn.microsoft.com/en-us/azure/devops/artifacts/concepts/best-practices?view=azure-devops
Use Azure Artifacts upstream sources effectively and safely https://learn.microsoft.com/en-us/azure/devops/artifacts/concepts/upstream-sources?view=azure-devops
Restore packages from upstream sources in Azure Artifacts safely https://learn.microsoft.com/en-us/azure/devops/artifacts/tutorials/protect-oss-packages-with-upstream-sources?view=azure-devops

Decision Making

Topic URL
Choose project vs organization-scoped Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/feeds/project-scoped-feeds?view=azure-devops
Plan migration from file shares to Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/nuget/move-from-fileshares?view=azure-devops
Migrate NuGet packages from MyGet to Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/tutorials/migrate-packages?view=azure-devops

Limits & Quotas

Topic URL
Monitor and manage Azure Artifacts storage limits https://learn.microsoft.com/en-us/azure/devops/artifacts/artifact-storage?view=azure-devops
Manage deletion and retention for Azure Artifacts packages https://learn.microsoft.com/en-us/azure/devops/artifacts/how-to/delete-and-recover-packages?view=azure-devops
Publish Azure Artifacts universal packages with size limits https://learn.microsoft.com/en-us/azure/devops/artifacts/quickstarts/universal-packages?view=azure-devops
Azure Artifacts package size and count limits https://learn.microsoft.com/en-us/azure/devops/artifacts/reference/limits?view=azure-devops

Security

Topic URL
Secure Azure Artifacts upstream sources against malicious packages https://learn.microsoft.com/en-us/azure/devops/artifacts/concepts/upstream-behavior?view=azure-devops
Configure Azure Artifacts feed and view permissions https://learn.microsoft.com/en-us/azure/devops/artifacts/feeds/feed-permissions?view=azure-devops

Configuration

Topic URL
Configure and manage Azure Artifacts feed views https://learn.microsoft.com/en-us/azure/devops/artifacts/feeds/views?view=azure-devops
Configure upstream sources for Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/how-to/set-up-upstream-sources?view=azure-devops
Configure npm .npmrc files for Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/npm/npmrc?view=azure-devops
Configure .artifactignore to optimize Azure Pipelines artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/reference/artifactignore?view=azure-devops

Integrations & Coding Patterns

Topic URL
Publish Cargo packages from CLI to Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/cargo/cargo-publish?view=azure-devops
Restore Cargo packages from Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/cargo/cargo-restore?view=azure-devops
Consume Cargo crates from Crates.io via Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/cargo/cargo-upstream-source?view=azure-devops
Connect Cargo projects to Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/cargo/project-setup-cargo?view=azure-devops
Publish and restore Rust Cargo packages with Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/get-started-cargo?view=azure-devops
Publish and restore Maven packages with Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/get-started-maven?view=azure-devops
Publish and consume npm packages with Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/get-started-npm?view=azure-devops
Add Gradle Plugins repository as Azure Artifacts upstream https://learn.microsoft.com/en-us/azure/devops/artifacts/maven/gradle-plugins?view=azure-devops
Configure Maven to restore packages from Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/maven/install?view=azure-devops
Configure JitPack as an Azure Artifacts upstream source https://learn.microsoft.com/en-us/azure/devops/artifacts/maven/jitpack-upstream?view=azure-devops
Connect Gradle builds to Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/maven/project-setup-gradle?view=azure-devops
Connect Maven projects to Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/maven/project-setup-maven?view=azure-devops
Publish Maven packages to Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/maven/publish-packages-maven?view=azure-devops
Publish packages with Gradle to Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/maven/publish-with-gradle?view=azure-devops
Consume Maven Central packages via Azure Artifacts upstream https://learn.microsoft.com/en-us/azure/devops/artifacts/maven/upstream-sources?view=azure-devops
Publish npm packages from CLI to Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/npm/publish?view=azure-devops
Restore npm packages from Azure Artifacts via CLI https://learn.microsoft.com/en-us/azure/devops/artifacts/npm/restore-npm-packages?view=azure-devops
Use npm registry packages through Azure Artifacts upstream https://learn.microsoft.com/en-us/azure/devops/artifacts/npm/upstream-sources?view=azure-devops
Publish NuGet packages via dotnet CLI to Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/nuget/dotnet-exe?view=azure-devops
Connect .NET projects to Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/nuget/dotnet-setup?view=azure-devops
Install NuGet packages from Azure Artifacts in Visual Studio https://learn.microsoft.com/en-us/azure/devops/artifacts/nuget/install-nuget-packages-with-visual-studio?view=azure-devops
Authenticate to Azure Artifacts using NuGet.exe https://learn.microsoft.com/en-us/azure/devops/artifacts/nuget/nuget-exe?view=azure-devops
Publish Azure Artifacts NuGet packages to NuGet.org https://learn.microsoft.com/en-us/azure/devops/artifacts/nuget/publish-to-nuget-org?view=azure-devops
Publish NuGet packages to Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/nuget/publish?view=azure-devops
Restore NuGet packages with dotnet from Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/nuget/restore-nuget-packages-dotnet?view=azure-devops
Restore NuGet packages with NuGet CLI from Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/nuget/restore-nuget-packages-nuget-exe?view=azure-devops
Connect Python projects to Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/python/project-setup-python?view=azure-devops
Download Universal Packages from Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/quickstarts/download-universal-packages?view=azure-devops
Install Python packages from Azure Artifacts feeds https://learn.microsoft.com/en-us/azure/devops/artifacts/quickstarts/install-python-packages?view=azure-devops
Publish Python packages to Azure Artifacts via CLI https://learn.microsoft.com/en-us/azure/devops/artifacts/quickstarts/python-cli?view=azure-devops
Publish and download Python packages with Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/quickstarts/python-packages?view=azure-devops
Debug with Azure Artifacts symbols in Visual Studio https://learn.microsoft.com/en-us/azure/devops/artifacts/symbols/debug-with-symbols-visual-studio?view=azure-devops
Debug with Azure Artifacts symbols using WinDbg https://learn.microsoft.com/en-us/azure/devops/artifacts/symbols/debug-with-symbols-windbg?view=azure-devops
Use PowerShell Gallery as an Azure Artifacts upstream source https://learn.microsoft.com/en-us/azure/devops/artifacts/tutorials/powershell-upstream-source?view=azure-devops
Use Azure Artifacts feed as a private PowerShell repository https://learn.microsoft.com/en-us/azure/devops/artifacts/tutorials/private-powershell-library?view=azure-devops
Connect and configure Universal Packages with Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/universal-packages/project-setup-universal-packages?view=azure-devops

Deployment

Topic URL
Use GitHub Actions workflows to push packages to Azure Artifacts https://learn.microsoft.com/en-us/azure/devops/artifacts/quickstarts/github-actions?view=azure-devops