alz-sync-troubleshoot

Installation
SKILL.md

ALZ Sync Troubleshooting Skill

This skill reproduces the ALZ Library sync workflow with a minimal scratch Definitions folder. Use it to investigate issues in New-ALZPolicyDefaultStructure and Sync-ALZPolicyFromLibrary (see Docs/integrating-with-alz-library.md).

It is intended for the GitHub Copilot cloud agent. Do not commit the generated Definitions/, policyStructures/, or temp/ folders – they are scratch artefacts.

When to use

Trigger this skill when the user reports problems such as:

  • New-ALZPolicyDefaultStructure failing or producing an empty / malformed default file
  • Sync-ALZPolicyFromLibrary throwing errors, missing parameters, or generating unexpected assignments
  • Issues specific to a -Tag, -LibraryPath, or a -Type (ALZ, AMBA, FSI, SLZ)
  • Differences between two ALZ Library tags
  • AMBA extended policies sync (-SyncAMBAExtendedPolicies)

Prerequisites

Installs
1
GitHub Stars
538
First Seen
Jun 16, 2026
alz-sync-troubleshoot — azure/enterprise-azure-policy-as-code