About azure-artifacts
A guidance skill for agents managing Azure Artifacts package feeds. It combines a local reference index with remote documentation retrieval for feed configuration, package workflows, security, and troubleshooting.
Key features
- 01Feed access and package troubleshooting
- 02Feed scope and migration guidance
- 03Storage, retention, and quota guidance
- 04Feed security and upstream sources
- 05Package publishing and restore workflows
Use cases
- 01Connecting build tools to package feeds
- 02Publishing and restoring packages in CI/CD
- 03Configuring upstream sources and feed permissions
MCP support
The skill can retrieve Microsoft documentation using mcp_microsoftdocs microsoft_docs_fetch, with webpage fetching as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-artifactsAfter installing, type/azure-artifactsin Claude Code to confirm it loaded.
Details
From the project READMEAzure 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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=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
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 |