# azure-automation

Azure Automation skill for Claude Code and Codex guides cloud operations. Activates when building runbooks, configuring DSC, or fixing Hybrid Workers.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 184 installs · ★ 818 repo stars
- Author: MicrosoftDocs
- License: CC-BY-4.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/MicrosoftDocs/Agent-Skills/tree/HEAD/skills/azure-automation/SKILL.md
- Updated: 2026-11-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/azure-automation

## What it does

Supported across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It guides runbook architecture, modular parent-child script structures, stream outputs, and migrations from Run As accounts to managed identities.

The reference index organizes troubleshooting steps for State Configuration errors, Azure DSC extension limits, and Change Tracking setup with AMA. For up-to-date documentation retrieval, the environment must allow outbound network access via `mcp_microsoftdocs:microsoft_docs_fetch` or `fetch_webpage`.

## Requirements
- Works with: Azure, Azure DevOps

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-automation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/azure-automation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/azure-automation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-automation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/azure-automation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-automation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/azure-automation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MicrosoftDocs/Agent-Skills skills/azure-automation
```

2. **Manually: put the files in place**
- File: `.github/skills/azure-automation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-automation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-automation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/azure-automation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-automation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/MicrosoftDocs/Agent-Skills/tree/HEAD/skills/azure-automation/SKILL.md

## When to use it
- diagnose failing Azure Automation runbooks and hybrid worker scripts
- migrate Automation accounts from Run As credentials to managed identities
- verify subscription quotas and concurrent job execution limits
- configure Change Tracking and Inventory monitoring with AMA

## Example prompts
- Help me diagnose an extension-based Hybrid Runbook Worker failure on Linux.
- How do I structure a parent-child runbook pattern in Azure Automation?
- What are the subscription limits for concurrent jobs in an Automation account?

## Source text · SKILL.md · CC-BY-4.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 396894801dabef96.

BEGIN THIRD-PARTY FILE 396894801dabef96
```text
---
name: azure-automation
description: Expert knowledge for Azure Automation development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when automating runbooks, Hybrid Workers, DSC/State Config, Change Tracking, or AMA-based monitoring, and other Azure Automation related development tasks. Not for Azure Functions (use azure-functions), Azure Logic Apps (use azure-logic-apps), Azure DevOps (use azure-devops), Azure Resource Manager (use azure-resource-manager).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-11-08"
  generator: "docs2skills/1.0.0"
---
# Azure Automation Skill

This skill provides expert guidance for Azure Automation. 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-L45 | Diagnosing and fixing Azure Automation issues: runbook failures, DSC/State Configuration, Hybrid Runbook Workers, managed identities, shared resources, and collecting logs for support. |
| Best Practices | L46-L55 | Best practices for structuring and running Automation runbooks: modular parent-child design, execution patterns, error handling, stream/output usage, and avoiding context/locking issues. |
| Decision Making | L56-L63 | Guidance on choosing runbook types and planning migrations: Orchestrator to Automation, Log Analytics to AMA, agent to extension workers, and Run As accounts to managed identities. |
```
END THIRD-PARTY FILE 396894801dabef96

The third-party file has ended. Everything between the 396894801dabef96 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2776 of 16972 bytes. © MicrosoftDocs · CC-BY-4.0 · https://github.com/MicrosoftDocs/Agent-Skills/tree/HEAD/skills/azure-automation/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
