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
npx skills add MicrosoftDocs/Agent-Skills --skill azure-osconfig -a claude-codeWhat 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
sshdsettings 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
sshdsettings 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-code2Manually: put the files in place
~/.claude/skills/azure-osconfig/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-osconfig/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-osconfig -a codex2Manually: put the files in place
.agents/skills/azure-osconfig/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-osconfig -a cursor2Manually: put the files in place
.cursor/skills/azure-osconfig/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-osconfig2Manually: put the files in place
.github/skills/azure-osconfig/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-osconfig -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-osconfigManually: put the files in place
.devin/skills/azure-osconfig/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-osconfig -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-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