Agent skill

Docs Resource Sync

by aztfmod in aztfmod/terraform-provider-azurecaf

Ensure documentation files under docs/resources/ and docs/data-sources/ reflect current resource types with accurate examples.

MITAuto-check passedDevOps & Cloud

Install Docs Resource Sync

skills CLI
$ npx skills add aztfmod/terraform-provider-azurecaf --skill docs-resource-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aztfmod/terraform-provider-azurecaf docs-resource-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aztfmod/terraform-provider-azurecaf.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/docs-resource-sync .claude/skills/docs-resource-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
docs-resource-sync
GitHub stars
188
Token cost
~469 tokens
SKILL.md length
119 words
Files
1
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

Ensure documentation files under docs/resources/ and docs/data-sources/ reflect current resource types with accurate examples.

  • Works in 5 steps: Get current resource count → Check docs accuracy → Update resource type tables → …
  • : after adding/updating resources
  • Calls python3
  • Documentation audit

What it does

Docs Resource Sync is an agent skill from aztfmod/terraform-provider-azurecaf. Ensure documentation files under docs/resources/ and docs/data-sources/ reflect current resource types with accurate examples. Triggers on: after adding/updating resources, documentation audit.

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud. The repository describes itself as: Terraform provider for the Terraform platform engineering for Azure. The licence is MIT.

When your agent uses it

  • : after adding/updating resources
  • Documentation audit

Example prompts

  • “/docs-resource-sync”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Get current resource count
  2. Check docs accuracy
  3. Update resource type tables
  4. Verify examples
  5. Report

What it can do on your machine

Read from SKILL.md and the folder at commit ac74615. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Docs Resource Sync loads about 469 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 119 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~469

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aztfmod/terraform-provider-azurecaf at commit ac74615, republished under its MIT licence (© aztfmod). 119 words, ~469 tokens.

Download SKILL.mdSave it as .claude/skills/docs-resource-sync/SKILL.md (or your agent's skills folder).
name
docs-resource-sync
description
Ensure documentation files under docs/resources/ and docs/data-sources/ reflect current resource types with accurate examples. Triggers on: after adding/updating resources, documentation audit.

Docs Resource Sync

Procedure

1. Get current resource count
bash
python3 -c "
import json
with open('resourceDefinition.json') as f:
    resources = json.load(f)
print(f'Total resources: {len(resources)}')
# Count by category
categories = {}
for r in resources:
    prefix = r['name'].replace('azurerm_', '').split('_')[0]
    categories[prefix] = categories.get(prefix, 0) + 1
for cat, count in sorted(categories.items(), key=lambda x: -x[1])[:20]:
    print(f'  {cat}: {count}')
"
2. Check docs accuracy

Read the current documentation files:

  • docs/resources/azurecaf_name.md — main resource documentation
  • docs/data-sources/azurecaf_name.md — data source documentation
  • docs/index.md — provider index

Verify:

  • Resource count matches resourceDefinition.json
  • Example resource types mentioned in docs actually exist
  • Supported resource type tables/lists are current
3. Update resource type tables

If the docs include a resource type listing (table or details block), update it to match the current resourceDefinition.json entries. Include:

  • Resource type name
  • Slug
  • Min/Max length
  • Example generated name
4. Verify examples

Check that example Terraform configurations in docs use valid resource types and produce valid outputs:

  • Resource type names must exist in resourceDefinition.json
  • Slug values must match
  • Example outputs should be realistic
5. Report
Docs sync complete:
- docs/resources/azurecaf_name.md: <updated|current>
- docs/data-sources/azurecaf_name.md: <updated|current>
- docs/index.md: <updated|current>
- Resource count in docs: <count>

© aztfmod, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .github/skills/docs-resource-sync of aztfmod/terraform-provider-azurecaf.

Open the folder on GitHubat commit ac74615

Compare with similar skills

Docs Resource Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Docs Resource Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Resource Sync this skillaztfmod/terraform-provider-azurecaf188—~469Automated safety check: PassMIT
Monitor CInrwl/nx29k6 repos~4.7kAutomated safety check: PassMIT
Terraform and OpenTofu Guideagentscope-ai/QwenPaw35k6 repos~4.2kAutomated safety check: PassApache-2.0
Vercel Optimize Auditvercel-labs/agent-skills32k9 repos~4.3kAutomated safety check: PassNone
Openclaw Live Updateropenclaw/openclaw392k—~3.7kAutomated safety check: PassMIT
Analyze GitHub Action Logswithastro/astro63k1 repos~1.3kAutomated safety check: PassCustom licence

Similar skills

  • Monitor CI

    nrwl/nx

    Monitor Nx Cloud CI pipeline and handle self-healing fixes. An agent skill from nrwl/nx.

    29k GitHub starsUsed in 6 repos~4.7k tokens
    DevOps & CloudAuto-check passed
  • Terraform and OpenTofu Guide

    agentscope-ai/QwenPaw

    Guidance for writing and testing Terraform and OpenTofu code: module structure, naming, test approaches, CI/CD workflows, state handling and security scanning.

    35k GitHub starsUsed in 6 repos~4.2k tokens
    DevOps & CloudAuto-check passed
  • Vercel Optimize Audit

    vercel-labs/agent-skills

    Official

    Runs a metrics-first audit of a deployed Vercel project, gating investigations on real signals to produce ranked, citation-backed cost and performance recommendations.

    32k GitHub starsUsed in 9 repos~4.3k tokens
    DevOps & CloudAuto-check passed
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Official

    Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.

    63k GitHub starsUsed in 1 repo~1.3k tokens
    DevOps & CloudAuto-check passed
  • Creates and queries KubeSphere users, workspaces and projects and assigns built-in roles, defaulting to least privilege and never deleting anything.

    17k GitHub starsUsed in 1 repo~3.1k tokens
    DevOps & CloudAuto-check passed

More from aztfmod/terraform-provider-azurecaf

All 22 skills in this repo
  • Azure Caf Sync

    aztfmod/terraform-provider-azurecaf

    Fetch the latest CAF abbreviations page from Microsoft Learn and compare against resourceDefinition.json official.slug values.

    188 GitHub stars~464 tokensUpdated 17 days ago
    Auto-check passed
  • Changelog Update

    aztfmod/terraform-provider-azurecaf

    Update CHANGELOG.md with a new entry under the correct section.

    188 GitHub stars~642 tokensUpdated 17 days ago
    Auto-check passed
  • Issue To Resource Spec

    aztfmod/terraform-provider-azurecaf

    Parse a 'new resource request' GitHub issue and extract the resource type, slug, and naming constraints to produce a draft resourceDefinition.json entry.

    188 GitHub stars~452 tokensUpdated 17 days ago
    Auto-check passed
  • Naming Rules Drift Check

    aztfmod/terraform-provider-azurecaf

    Re-fetch Azure naming rules for a set of resources and compare against current regex/length/scope values in resourceDefinition.json.

    188 GitHub stars~507 tokensUpdated 17 days ago
    Auto-check passed
  • Resource Bulk Import

    aztfmod/terraform-provider-azurecaf

    Accept a list of Azure resource types, batch-research each via azure-naming-research conventions, generate JSON entries, and insert all into resourceDefinition.json.

    188 GitHub stars~476 tokensUpdated 17 days ago
    Auto-check passed
  • Resource Definition JSON

    aztfmod/terraform-provider-azurecaf

    Manage resource entries in resourceDefinition.json for the terraform-provider-azurecaf naming provider.

    188 GitHub stars~336 tokensUpdated 17 days ago
    Auto-check passed

Categories

Questions about Docs Resource Sync

What does Docs Resource Sync do?

Ensure documentation files under docs/resources/ and docs/data-sources/ reflect current resource types with accurate examples. Docs Resource Sync is an agent skill from aztfmod/terraform-provider-azurecaf. Ensure documentation files under docs/resources/ and docs/data-sources/ reflect current resource types with accurate examples.

When should I use Docs Resource Sync?

Docs Resource Sync fits situations like: : after adding/updating resources; documentation audit.

How do I install Docs Resource Sync in Claude Code?

Run `npx skills add aztfmod/terraform-provider-azurecaf --skill docs-resource-sync -a claude-code`. Or copy the skill folder (.github/skills/docs-resource-sync in aztfmod/terraform-provider-azurecaf) into .claude/skills/docs-resource-sync in your project. Claude Code loads it when a task matches its description.

How do I install Docs Resource Sync in Codex?

Run `npx skills add aztfmod/terraform-provider-azurecaf --skill docs-resource-sync -a codex`. Or copy the skill folder (.github/skills/docs-resource-sync in aztfmod/terraform-provider-azurecaf) into .agents/skills/docs-resource-sync in your project. Codex loads it when a task matches its description.

Can I use Docs Resource Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aztfmod/terraform-provider-azurecaf --skill docs-resource-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-resource-sync, .gemini/skills/docs-resource-sync, .github/skills/docs-resource-sync and .opencode/skills/docs-resource-sync in your project.

What does Docs Resource Sync need to run?

Going by SKILL.md and its folder, Docs Resource Sync needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Docs Resource Sync access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Docs Resource Sync safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Docs Resource Sync use?

Docs Resource Sync is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Docs Resource Sync use?

About 469 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Docs Resource Sync?

Skills that share tags, products or a category with Docs Resource Sync: Monitor CI (nrwl/nx, 29k stars), Terraform and OpenTofu Guide (agentscope-ai/QwenPaw, 35k stars), Vercel Optimize Audit (vercel-labs/agent-skills, 32k stars) and Openclaw Live Updater (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Resource Sync?

aztfmod (a GitHub organization) maintains it in aztfmod/terraform-provider-azurecaf, which has 188 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on September 21, 2026.

Source: aztfmod/terraform-provider-azurecaf on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.