/azure-artifacts

name: azure-artifacts
description: 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).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-10-18"
  generator: "docs2skills/1.0.0"

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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

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 permissi