{"id":"db455149-382d-47e5-aa57-39ac20503d62","shortId":"8Zbc26","kind":"skill","title":"azure-osconfig","tagline":"Expert knowledge for Azure Osconfig development including troubleshooting, security, configuration, and integrations & coding patterns. Use when running OSConfig via IoT Hub for commands, SSH posture, agent health, Windows baselines, or LAPS, and other Azure Osconfig related deve","description":"# Azure Osconfig Skill\n\nThis 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.\n\n## How to Use This Skill\n\n> **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\n\n> **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)\n\nThis skill requires **network access** to fetch documentation content:\n- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.\n- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.\n\n## Category Index\n\n| Category | Lines | Description |\n|----------|-------|-------------|\n| 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. |\n| Security | L37-L42 | Configuring Windows security via OSConfig: App Control for Business, Windows Server 2025 security baselines, and Windows LAPS with Azure Arc and Policy. |\n| Configuration | L43-L48 | Tracking OSConfig breaking changes over time and configuring/standardizing sshd settings across fleets using SSH Posture Control. |\n| Integrations & Coding Patterns | L49-L61 | Patterns for using OSConfig with Azure IoT to run custom commands, manage Linux networking, firewall, packages, hostnames, reboots, and report device/OS hardware info. |\n\n### Troubleshooting\n| Topic | URL |\n|-------|-----|\n| Diagnose OSConfig status when using Azure IoT Hub | https://learn.microsoft.com/en-us/azure/osconfig/howto-troubleshoot |\n\n### Security\n| Topic | URL |\n|-------|-----|\n| Configure App Control for Business policies via OSConfig | https://learn.microsoft.com/en-us/azure/osconfig/osconfig-how-to-configure-app-control-for-business |\n| Configure Windows Server 2025 security baselines with OSConfig | https://learn.microsoft.com/en-us/azure/osconfig/osconfig-how-to-configure-security-baselines |\n\n### Configuration\n| Topic | URL |\n|-------|-----|\n| Track major OSConfig breaking changes over time | https://learn.microsoft.com/en-us/azure/osconfig/concept-majorchanges |\n| Manage sshd configuration fleetwide with SSH Posture Control | https://learn.microsoft.com/en-us/azure/osconfig/ssh-brownfield-mc |\n\n### Integrations & Coding Patterns\n| Topic | URL |\n|-------|-----|\n| Use OSConfig CommandRunner for custom device commands | https://learn.microsoft.com/en-us/azure/osconfig/concept-commandrunner |\n| Implement custom configuration and reporting with OSConfig CommandRunner | https://learn.microsoft.com/en-us/azure/osconfig/howto-customconfigreport |\n| Report device hardware and OS info with OSConfig | https://learn.microsoft.com/en-us/azure/osconfig/howto-deviceinfo |\n| Manage Linux host firewall using OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-firewall |\n| Manage OS hostnames using OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-hostname |\n| Control /etc/hosts content with OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-hosts |\n| Configure Linux network settings via OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-network |\n| Manage Linux package manager through OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-pmc |\n| Trigger device reboot and shutdown via OSConfig and Azure IoT | https://learn.microsoft.com/en-us/azure/osconfig/howto-rebootshutdown |\n| Run Azure IoT Hub queries for OSConfig-enabled devices | https://learn.microsoft.com/en-us/azure/osconfig/quickstart-useful-queries |","tags":["azure","osconfig","agent","skills","microsoftdocs","agent-skills","agentic-skills","agentskill","ai-agents","ai-coding","azure-functions","azure-kubernetes-service"],"capabilities":["skill","source-microsoftdocs","skill-azure-osconfig","topic-agent","topic-agent-skills","topic-agentic-skills","topic-agentskill","topic-ai-agents","topic-ai-coding","topic-azure","topic-azure-functions","topic-azure-kubernetes-service","topic-azure-openai","topic-azure-sql-database","topic-azure-storage"],"categories":["Agent-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-osconfig","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MicrosoftDocs/Agent-Skills","source_repo":"https://github.com/MicrosoftDocs/Agent-Skills","install_from":"skills.sh"}},"qualityScore":"0.698","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 497 github stars · SKILL.md body (4,265 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T00:53:35.235Z","embedding":null,"createdAt":"2026-04-18T21:59:41.659Z","updatedAt":"2026-04-22T00:53:35.235Z","lastSeenAt":"2026-04-22T00:53:35.235Z","tsv":"'/en-us/azure/osconfig/concept-commandrunner':385 '/en-us/azure/osconfig/concept-majorchanges':359 '/en-us/azure/osconfig/howto-customconfigreport':396 '/en-us/azure/osconfig/howto-deviceinfo':407 '/en-us/azure/osconfig/howto-firewall':419 '/en-us/azure/osconfig/howto-hostname':430 '/en-us/azure/osconfig/howto-hosts':441 '/en-us/azure/osconfig/howto-network':453 '/en-us/azure/osconfig/howto-pmc':465 '/en-us/azure/osconfig/howto-rebootshutdown':478 '/en-us/azure/osconfig/howto-troubleshoot':321 '/en-us/azure/osconfig/osconfig-how-to-configure-app-control-for-business':335 '/en-us/azure/osconfig/osconfig-how-to-configure-security-baselines':346 '/en-us/azure/osconfig/quickstart-useful-queries':491 '/en-us/azure/osconfig/ssh-brownfield-mc':370 '/etc/hosts':432 '/microsoftdocs/mcp/blob/main/readme.md)':159 '2025':248,339 '3':130 'accept':198 'access':164 'across':273 'agent':29,79,123,182,196,213 'app':242,326 'arc':256 'avail':149 'azur':2,7,37,41,50,220,255,290,316,415,426,437,449,461,474,480 'azure-osconfig':1 'baselin':32,250,341 'break':265,353 'busi':245,329 'capabl':71 'categori':82,90,106,202,204 'chang':266,354 'check':224 'code':16,58,280,372 'combin':61 'command':26,295,382 'commandrunn':378,393 'configur':13,55,237,259,325,336,347,362,388,442 'configuring/standardizing':270 'connect':216 'content':66,168,433 'control':243,278,327,367,431 'cover':52 'custom':294,380,387 'deploy':229 'descript':206 'deve':40 'develop':9 'devic':381,398,467,488 'device/os':305 'diagnos':211,311 'doc':174 'document':69,167 'e.g':94,110 'enabl':487 'expert':4,47 'fallback':186 'fetch':70,166,175,188 'file':100,108,115,120 'firewal':299,411 'fleet':274 'fleetwid':363 'github.com':158 'github.com/microsoftdocs/mcp/blob/main/readme.md)':157 'guid':156 'guidanc':48 'hardwar':306,399 'health':30,226 'host':410 'hostnam':301,422 'hub':24,222,318,482 'implement':386 'import':77,121 'includ':10,223 'index':83,203 'info':307,402 'instal':153,155 'integr':15,57,279,371 'iot':23,221,291,317,416,427,438,450,462,475,481 'issu':217 'knowledg':5 'l120':97 'l32':209 'l32-l36':208 'l35':96 'l35-l120':95 'l36':210 'l37':235 'l37-l42':234 'l42':236 'l43':261 'l43-l48':260 'l48':262 'l49':283 'l49-l61':282 'l61':284 'lap':34,253 'latest':138 'learn':181,195 'learn-agent-skil':180,194 'learn.microsoft.com':320,334,345,358,369,384,395,406,418,429,440,452,464,477,490 'learn.microsoft.com/en-us/azure/osconfig/concept-commandrunner':383 'learn.microsoft.com/en-us/azure/osconfig/concept-majorchanges':357 'learn.microsoft.com/en-us/azure/osconfig/howto-customconfigreport':394 'learn.microsoft.com/en-us/azure/osconfig/howto-deviceinfo':405 'learn.microsoft.com/en-us/azure/osconfig/howto-firewall':417 'learn.microsoft.com/en-us/azure/osconfig/howto-hostname':428 'learn.microsoft.com/en-us/azure/osconfig/howto-hosts':439 'learn.microsoft.com/en-us/azure/osconfig/howto-network':451 'learn.microsoft.com/en-us/azure/osconfig/howto-pmc':463 'learn.microsoft.com/en-us/azure/osconfig/howto-rebootshutdown':476 'learn.microsoft.com/en-us/azure/osconfig/howto-troubleshoot':319 'learn.microsoft.com/en-us/azure/osconfig/osconfig-how-to-configure-app-control-for-business':333 'learn.microsoft.com/en-us/azure/osconfig/osconfig-how-to-configure-security-baselines':344 'learn.microsoft.com/en-us/azure/osconfig/quickstart-useful-queries':489 'learn.microsoft.com/en-us/azure/osconfig/ssh-brownfield-mc':368 'line':92,104,205 'link':109,118 'linux':297,409,443,455 'local':62 'locat':86 'log':225 'major':351 'manag':296,360,408,420,454,457 'markdown':185,201 'mcp':144,171 'metadata.generated':125 'microsoft':173 'microsoftdoc':145,172 'month':131 'network':163,298,444 'old':132 'os':401,421 'osconfig':3,8,21,38,42,51,212,241,264,288,312,332,343,352,377,392,404,413,424,435,447,459,472,486 'osconfig-en':485 'packag':300,456 'pattern':17,59,281,285,373 'polici':258,330 'postur':28,277,366 'prefer':169 'problem':232 'provid':46 'pull':136 'queri':177,191,483 'quick':64 'quick-refer':63 'rang':93 'read':99,114 'reboot':302,468 'refer':65,119 'relat':39 'relev':87 'remot':68 'report':231,304,390,397 'repositori':142 'requir':162 'return':184,200 'run':20,293,479 'section':88 'secur':12,54,233,239,249,322,340 'security.md':111,112 'server':247,338 'set':272,445 'shutdown':470 'skill':43,45,76,161,183,197 'skill-azure-osconfig' 'source-microsoftdocs' 'specifi':103 'ssh':27,276,365 'sshd':271,361 'status':214,313 'string':178,192 'suggest':133,150 'text/markdown':199 'time':268,356 'tool':146 'topic':309,323,348,374 'topic-agent' 'topic-agent-skills' 'topic-agentic-skills' 'topic-agentskill' 'topic-ai-agents' 'topic-ai-coding' 'topic-azure' 'topic-azure-functions' 'topic-azure-kubernetes-service' 'topic-azure-openai' 'topic-azure-sql-database' 'topic-azure-storage' 'track':263,350 'trigger':466 'troubleshoot':11,53,207,228,308 'url':310,324,349,375 'use':18,74,80,98,113,170,187,219,275,287,315,376,412,423 'user':135,152 'version':139 'via':22,240,331,446,471 'webpag':189 'window':31,238,246,252,337","prices":[{"id":"4d50cf8d-42f4-476a-af68-9d04e23f48e5","listingId":"db455149-382d-47e5-aa57-39ac20503d62","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MicrosoftDocs","category":"Agent-Skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:59:41.659Z"}],"sources":[{"listingId":"db455149-382d-47e5-aa57-39ac20503d62","source":"github","sourceId":"MicrosoftDocs/Agent-Skills/azure-osconfig","sourceUrl":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-osconfig","isPrimary":false,"firstSeenAt":"2026-04-18T21:59:41.659Z","lastSeenAt":"2026-04-22T00:53:35.235Z"}],"details":{"listingId":"db455149-382d-47e5-aa57-39ac20503d62","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MicrosoftDocs","slug":"azure-osconfig","github":{"repo":"MicrosoftDocs/Agent-Skills","stars":497,"topics":["agent","agent-skills","agentic-skills","agentskill","ai","ai-agents","ai-coding","azure","azure-functions","azure-kubernetes-service","azure-openai","azure-sql-database","azure-storage","azure-virtual-machine","claude-code","github-copilot","microsoft-learn","openai-codex","skills"],"license":"cc-by-4.0","html_url":"https://github.com/MicrosoftDocs/Agent-Skills","pushed_at":"2026-04-19T02:43:40Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"a1a6e002d2d9126617518c10d5d6dcd812c60cd2","skill_md_path":"skills/azure-osconfig/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-osconfig"},"layout":"multi","source":"github","category":"Agent-Skills","frontmatter":{"name":"azure-osconfig","description":"Expert knowledge for Azure Osconfig development including troubleshooting, security, configuration, and integrations & coding patterns. Use when running OSConfig via IoT Hub for commands, SSH posture, agent health, Windows baselines, or LAPS, 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."},"skills_sh_url":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-osconfig"},"updatedAt":"2026-04-22T00:53:35.235Z"}}