azure-artifacts — Claude Code skill: use and install
This skill guides Azure Artifacts work: feed setup, package publishing, upstream sources, and troubleshooting. Use it when the task concerns Azure Artifacts.
CC-BY-4.0 188 installs ★ 818 updated 2026-10-25
npx skills add MicrosoftDocs/Agent-Skills --skill azure-artifacts -a claude-codeWhat azure-artifacts does
The skill provides focused guidance for Azure Artifacts. It covers feed access and authentication failures, package restore and publishing issues, feed scope decisions, migrations, storage limits, retention, permissions, views, upstream sources, npm .npmrc settings, .artifactignore, and GitHub Actions publishing.
It combines a local reference with remote documentation retrieval through mcp_microsoftdocs:microsoft_docs_fetch, with fetch_webpage as the fallback. The category index points the agent to the relevant section. Network access is required, so documentation retrieval will fail without it. Azure DevOps, Azure Pipelines, Azure Repos, and Azure Boards tasks belong to separate skills.
What it helps with
- diagnose a feed access failure
- configure upstream sources and feed views
- set up npm
.npmrcauthentication - check package limits and retention rules
- publish packages from GitHub Actions
Example prompts for the agent
- Investigate this Azure Artifacts feed access error and give me the checks to run.
- Configure npm
.npmrcfor our Azure Artifacts feed and explain the authentication steps. - Show how to publish this package to Azure Artifacts from GitHub Actions, including relevant limits.
How to install azure-artifacts
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-artifacts -a claude-code2Manually: put the files in place
~/.claude/skills/azure-artifacts/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-artifacts/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-artifacts -a codex2Manually: put the files in place
.agents/skills/azure-artifacts/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-artifacts -a cursor2Manually: put the files in place
.cursor/skills/azure-artifacts/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-artifacts2Manually: put the files in place
.github/skills/azure-artifacts/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-artifacts -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-artifactsManually: put the files in place
.devin/skills/azure-artifacts/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-artifacts -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-artifacts
How do I install azure-artifacts in Claude Code?
Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-artifacts -a claude-code. The skill will then be available at ~/.claude/skills/azure-artifacts/SKILL.md.
What does azure-artifacts do?
It helps with Azure Artifacts feeds, upstream sources, views, npm authentication, package restore and publishing, troubleshooting, and deployment guidance. The agent can retrieve Microsoft documentation for the relevant topic.
Does azure-artifacts require network access?
Yes. It retrieves documentation with mcp_microsoftdocs:microsoft_docs_fetch or the fetch_webpage fallback, so network access is required.
Source text
SKILL.md · CC-BY-4.0
--- 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 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 |
© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills