azure-caf-sync - SKILL.md Agent Skill

name: azure-caf-sync description: "Fetch the latest CAF abbreviations page from Microsoft Learn and compare against resourceDefinition.json official.slug values. Reports drift where the provider's slug differs from the official CAF slug. Triggers on: weekly scheduled audit, manual sync check."

Azure CAF Sync

Procedure

1. Fetch CAF abbreviations

Use Microsoft Docs MCP tools (microsoft_docs_fetch) to fetch the latest version:

URL: https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/ready/azure-best-practices/resource-abbreviations

Extract all rows from the abbreviation table: resource name, abbreviation (slug), resource provider namespace.

2. Extract current provider slugs

python3 -c "
import json
with open('resourceDefinition.json') as f:
    resources = json.load(f)
for r in resources:
    official = r.get('official', {})
    ns = official.get('resource_provider_namespace', '')
    official_slug = official.get('slug', '')
    print(f'{r[\"name\"]}|{r[\"slug\"]}|{official_slug}|{ns}')
" > /tmp/caf-current.txt

3. Compare

For each resource in the provider that has an official.resource_provider_namespace:

Find the matching entry in the CAF abbreviations page
Compare the provider's slug against the official CAF abbreviation
Flag mismatches

4. Report

## CAF Slug Drift Report

### Mismatches (<count>)
| Resource | Provider Slug | Official CAF Slug | Namespace |
|----------|--------------|-------------------|-----------|
| <name>   | <current>    | <official>        | <ns>      |

### New in CAF (not in provider) (<count>)
| Resource | CAF Slug | Namespace |
|----------|----------|-----------|
| <name>   | <slug>   | <ns>      |

### Summary
- Resources checked: <count>
- Matches: <count>
- Mismatches: <count>
- New resources in CAF: <count>