Skip to main content
skill CX Codex

azure-osconfig — Claude Code skill: features and installation

This skill guides Azure OSConfig development, from diagnosing agent and Azure IoT Hub issues to configuring Windows security and Linux devices.

CC-BY-4.0 161 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-osconfig -a claude-code
Open on GitHub

What azure-osconfig does

The skill covers troubleshooting OSConfig agent health and connectivity with Azure IoT Hub. Its security references include App Control for Business policies, Windows Server security baselines, CIS benchmarks, and SSH Posture Control for managing sshd across devices.

Integration guidance describes CommandRunner patterns for custom commands and reporting, along with Linux networking, firewalls, package managers, hostnames, and device reboots. It also covers reporting hardware and OS details. Fetching documentation requires network access and uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage; remote references cannot be retrieved offline.

Install it in Claude Code with npx skills add MicrosoftDocs/Agent-Skills --skill azure-osconfig -a claude-code. The skill file is at ~/.claude/skills/azure-osconfig/SKILL.md. Its scope is Azure OSConfig, not Azure Update Manager, Azure Automation, or Azure Policy.

What it helps with

  • diagnose OSConfig agent health and Azure IoT Hub connectivity
  • configure Windows security policies and CIS benchmarks
  • standardize sshd settings across devices
  • manage Linux networking, firewalls, and packages through OSConfig
  • report device operating system and hardware details

Example prompts for the agent

  • Diagnose why my OSConfig agent cannot connect to Azure IoT Hub and suggest checks.
  • Show how to standardize sshd settings across my devices with OSConfig.
  • Explain how CommandRunner can manage a Linux firewall and report device details.

How to install azure-osconfig

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-osconfig -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-osconfig/SKILL.md

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

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

Questions about azure-osconfig

How do I install azure-osconfig in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-osconfig -a claude-code. The skill file is located at ~/.claude/skills/azure-osconfig/SKILL.md.

What does azure-osconfig do?

It provides guidance for Azure OSConfig development, including agent troubleshooting, Windows security configuration, SSH settings, and Linux device management through Azure IoT.

Does azure-osconfig need network access?

Yes. It retrieves documentation through mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage, so remote references require a network connection.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-osconfig
description: Expert knowledge for Azure Osconfig development including troubleshooting, security, configuration, and integrations & coding patterns. Use when running OSConfig via IoT for commands/networking, SSH Posture Control, agent health, or Windows security baselines, and other Azure Osconfig related development tasks. Not for Azure Update Manager (use azure-update-manager), Azure Automation (use azure-automation), Azure Policy (use azure-policy).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-05-24"
  generator: "docs2skills/1.0.0"
---
# Azure Osconfig Skill

This skill provides expert guidance for Azure Osconfig. Covers troubleshooting, 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 | L32-L36 | Diagnosing OSConfig agent status and connectivity issues when using Azure IoT Hub, including checking logs, health, and troubleshooting deployment or reporting problems. |
| Security | L37-L43 | Configuring Windows security with OSConfig: App Control for Business policies, Windows Server 2025 security baselines, and applying CIS benchmarks to Azure Windows Server. |
| Configuration | L44-L49 | Tracking OSConfig breaking changes over time and configuring/standardizing sshd settings across fleets using SSH Posture Control. |
| Integrations & Coding Patterns | L50-L62 | Patterns for using OSConfig with Azure IoT to run custom commands, manage Linux networking, firewall, packages, hostnames, reboots, and report device/OS hardware info. |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Diagnose OSConfig status when using Azure IoT Hub | https://learn.microsoft.com/en-us/azure/osconfig/howto-troubleshoot |

### Security
| Topic | URL |
|-------|-----|
| Configure App Control for Business policies via OSConfig | https://learn.microsoft.com/en-us/azure/osconfig/osconfig-how-to-configure-app-control-for-business |
| Configure Windows Server 2025 security baselines with OSConfig | https://learn.microsoft.com/en-us/azure/osconfig/osconfig-how-to-configure-security-baselines |
| Apply CIS security benchmarks to Azure Windows Server | https://learn.microsoft.com/en-us/azure/osconfig/overview-cis-benchmarks-windows-server |

### Configuration
| Topic | URL |
|-------|-----|
| Track major OSConfig breaking changes over time | https://learn.microsoft.com/en-us/azure/osconfig/concept-majorchanges |
| Manage sshd configuration fleetwide with SSH Posture Control | https://learn.microsoft.com/en-us/azure/osconfig/ssh-brownfield-mc |

### Integrations & Coding Patterns
| Topic | URL |
|-------|-----|
| Use OSConfig CommandRunner for custom device commands | https://learn.microsoft.com/en-us/azure/osconfig/concept-commandrunner |
| Implement custom configuration and reporting with OSConfig CommandRunner | https://learn.microsoft.com/en-us/azure/osconfig/howto-customconfigreport |
| Report device hardware and OS info with OSConfig | https://learn.microsoft.com/en-us/azure/osconfig/howto-deviceinfo |
| Manage Linux host firewall using OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-firewall |
| Manage OS hostnames using OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-hostname |
| Control /etc/hosts content with OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-hosts |
| Configure Linux network settings via OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-network |
| Manage Linux package manager through OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-pmc |
| Trigger device reboot and shutdown via OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-rebootshutdown |
| Run Azure IoT Hub queries for OSConfig-enabled devices | https://learn.microsoft.com/en-us/azure/osconfig/quickstart-useful-queries |

© 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-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 azure-dedicated-hsm Hands the agent a working map of Azure Dedicated HSM: cluster sizing, networking, secure configuration and migration, with links into Microsoft Learn. CX Codex +1 162installs azure-open-datasets A reference skill for Azure Open Datasets limits: throttling on non-Spark downloads, quota ceilings and retry handling, pulled from Microsoft Learn docs. CX Codex +1 161installs azure-immersive-reader A skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that brings Azure AI Immersive Reader expertise to the agent. Covers JS SDK integration, Entra auth setup, read-aloud configuration, and language support. CX Codex +1 161installs azure-import-export This skill guides work on Azure Import/Export jobs, from diagnosing failures to checking service limits and configuring encryption keys. Use it while building or troubleshooting these jobs. CX Codex +1 161installs azure-payment-hsm azure-payment-hsm is a Claude Code skill for configuring Azure Payment HSM and diagnosing deployment issues. It activates for work on VNets, FastPath, payShield Manager, traffic routing, or HA/DR design. CX Codex +1 161installs

Project sponsors

Companies that keep this analytics open