Skip to main content
skill CX Codex

azure-operator-service-manager — Claude Code skill: guide and setup

Guides configuration, onboarding, and troubleshooting for Azure Operator Service Manager in developer agents.

CC-BY-4.0 162 installs ★ 818 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-operator-service-manager -a claude-code
Open on GitHub

What azure-operator-service-manager does

The skill adds domain instructions for Azure Operator Service Manager (AOSM) directly to agent sessions. It covers designing configuration groups, packaging CNFs with Helm charts, publishing publisher resources, and managing ACR-backed artifact stores.

Under the hood, the skill links targeted topics to remote Microsoft documentation endpoints. When deeper context is needed, the agent invokes mcp_microsoftdocs:microsoft_docs_fetch or falls back to fetch_webpage with specific query parameters to pull raw Markdown.

Network connectivity is mandatory for retrieving the latest reference articles. This module targets AOSM specifically; alternative skills handle Azure Operator Nexus, Azure Operator Insights, and general Azure Resource Manager tasks.

What it helps with

  • resolve Helm chart deployment errors during AOSM CNF installation
  • configure Private Link and custom RBAC permissions for operator services
  • manage container images and artifact store replication with the AOSM CLI
  • set up cluster registries to maintain edge workload resiliency

Example prompts for the agent

  • Troubleshoot Helm installation failure during CNF deployment in AOSM
  • Set up custom RBAC roles and Managed Identity for AOSM service operators
  • Map parameters between Helm charts and AOSM configuration group schemas

How to install azure-operator-service-manager

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-operator-service-manager -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-operator-service-manager/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-operator-service-manager/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about azure-operator-service-manager

How to install azure-operator-service-manager in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-operator-service-manager -a claude-code in your terminal.

What does azure-operator-service-manager do?

It equips the agent with best practices, CLI workflows, and diagnostic procedures for deploying telecommunications workloads with AOSM.

Which external tools are needed for full functionality?

It needs working network access and the mcp_microsoftdocs MCP server or fetch_webpage to retrieve official Microsoft reference docs.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-operator-service-manager
description: Expert knowledge for Azure Operator Service Manager development including troubleshooting, best practices, security, configuration, and integrations & coding patterns. Use when onboarding CNFs/VNFs with Helm, managing ACR artifacts, configuring cluster registry, Private Link, or RBAC, and other Azure Operator Service Manager related development tasks. Not for Azure Operator Insights (use azure-operator-insights), Azure Operator Nexus (use azure-operator-nexus), Azure Resource Manager (use azure-resource-manager), Azure Networking (use azure-networking).
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 Operator Service Manager Skill

This skill provides expert guidance for Azure Operator Service Manager. Covers troubleshooting, best practices, 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](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 | L33-L38 | Diagnosing and fixing AOSM onboarding issues with the Azure CLI extension and troubleshooting Helm chart installation failures in AOSM CNF deployments. |
| Best Practices | L39-L47 | Best practices for onboarding/deploying AOSM, designing configuration groups, packaging CNFs with Helm, cleaning up publisher resources, and controlling CNF upgrade failure behavior. |
| Security | L48-L55 | Securing AOSM with Private Link, custom RBAC/roles, and User Assigned Managed Identities for controlled, least-privilege access and secure SNS/service operator deployments. |
| Configuration | L56-L65 | Configuring AOSM deployment behavior: cluster registry for edge resiliency, pausing/resuming site services, Helm cleanup/tests, NFO extension settings, and artifact store geo-replication. |
| Integrations & Coding Patterns | L66-L75 | Using CLI/ARM/Helm with AOSM to onboard CNFs/VNFs, manage images and artifacts (ACR/storage-backed stores), and add ARM resources to network service designs |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Troubleshoot Azure CLI AOSM extension onboarding issues | https://learn.microsoft.com/en-us/azure/operator-service-manager/troubleshoot-cli-common-issues |
| Diagnose Helm install failures in AOSM CNF deployments | https://learn.microsoft.com/en-us/azure/operator-service-manager/troubleshoot-helm-install-failures |

### Best Practices
| Topic | URL |
|-------|-----|
| Apply onboarding and deployment best practices for AOSM | https://learn.microsoft.com/en-us/azure/operator-service-manager/best-practices-onboard-deploy |
| Design configuration groups effectively in Azure Operator Service Manager | https://learn.microsoft.com/en-us/azure/operator-service-manager/configuration-guide |
| Apply Helm chart best practices for Azure Operator Service Manager | https://learn.microsoft.com/en-us/azure/operator-service-manager/helm-requirements |
| Manage AOSM publisher resource clean-up effectively | https://learn.microsoft.com/en-us/azure/operator-service-manager/resource-cleanup-management |
| Control CNF upgrade failure behavior in AOSM | https://learn.microsoft.com/en-us/azure/operator-service-manager/safe-upgrades-nf-level-rollback |

### Security
| Topic | URL |
|-------|-----|
| Configure AOSM Private Link for secure backhaul | https://learn.microsoft.com/en-us/azure/operator-service-manager/get-started-with-private-link |
| Assign custom AOSM roles for secure SNS deployment | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-assign-custom-role |
| Create custom RBAC roles for AOSM service operators | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-create-custom-role |
| Configure and use User Assigned Managed Identity with AOSM | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-create-user-assigned-managed-identity |

### Configuration
| Topic | URL |
|-------|-----|
| Set up AOSM cluster registry for edge resiliency | https://learn.microsoft.com/en-us/azure/operator-service-manager/get-started-with-cluster-registry |
| Interrupt and resume AOSM site network service deployments | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-cancel-service-deployments |
| Override Helm failure cleanup behavior in AOSM deployments | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-use-helm-option-parameters |
| Use CLI commands to configure NFO cluster extension | https://learn.microsoft.com/en-us/azure/operator-service-manager/manage-network-function-operator |
| Configure geo-replication for AOSM artifact stores | https://learn.microsoft.com/en-us/azure/operator-service-manager/publisher-artifact-store-resiliency |
| Configure Helm test integration for AOSM upgrades | https://learn.microsoft.com/en-us/azure/operator-service-manager/safe-upgrades-helm-test |

### Integrations & Coding Patterns
| Topic | URL |
|-------|-----|
| Use AOSM CLI to discover and upload CNF images | https://learn.microsoft.com/en-us/azure/operator-service-manager/concepts-cli-containerized-network-function-image-upload |
| Map Helm and ARM parameters to AOSM configuration | https://learn.microsoft.com/en-us/azure/operator-service-manager/concepts-expose-parameters-configuration-group-schema |
| Push and pull artifacts with ACR-backed AOSM artifact stores | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-manage-artifacts-nexus |
| Push and pull artifacts with AOSM storage-backed stores | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-manage-artifacts-virtualized-network-function-cloud |
| Add ARM resources to AOSM Network Service Designs via CLI | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-onboard-azure-resource-manager-resources-cli |
| Onboard CNFs to AOSM using the CLI extension | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-onboard-containerized-network-function-cli |
| Onboard VNFs to AOSM for deployment on Nexus | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-onboard-virtualized-network-function-cli |

© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set144

The whole set →
azure-partner-solutions This skill for Claude Code covers Azure Partner Solutions, from configuration and security to integrations and architecture. It fetches documentation for Confluent, Datadog, MongoDB and related services. CX Codex +1 163installs azure-information-protection A MicrosoftDocs skill that keeps Azure Information Protection guidance close at hand: Azure RMS versus AD RMS, connector setup, and the AD RMS migration phases. CX Codex +1 163installs azure-defender-for-iot Provides guidance for Azure Defender for IoT, covering OT sensor placement, micro agent troubleshooting, and traffic mirroring in Claude Code. CX Codex +1 163installs azure-oracle azure-oracle is a Claude Code skill that indexes Microsoft Learn material for Oracle Database@Azure: known issues, TDE with Key Vault, and Exadata log export to Monitor and Sentinel. CX Codex +1 162installs azure-planetary-computer-pro The azure-planetary-computer-pro skill guides agents through Microsoft Planetary Computer Pro work, from GeoCatalog and STAC APIs to security, configuration, and integrations. CX Codex +1 162installs azure-large-instances Hands the agent a working reference for Azure Large Instances: Epic SKU caps, volume group sizing, EHR storage, connection faults. CX Codex +1 162installs azure-data-share Guides agents through Azure Data Share architecture, troubleshooting, and deployments using official Microsoft Learn docs. CX Codex +1 162installs azure-relay This skill guides Azure Relay setup, error diagnosis, and Hybrid Connections work. It fits projects using .NET or Node.js relay clients. CX Codex +1 162installs

Project sponsors

Companies that keep this analytics open