Official agent skill

Sync Go Modules

by kubernetes-sigs in kubernetes-sigs/cloud-provider-azure

Synchronize all tracked Go modules with the go-mod-consistency CI and refresh the root vendor tree.

OfficialApache-2.0Auto-check passedDevOps & Cloud

Install Sync Go Modules

skills CLI
$ npx skills add kubernetes-sigs/cloud-provider-azure --skill sync-go-modules -a claude-code

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

GitHub CLI
$ gh skill install kubernetes-sigs/cloud-provider-azure sync-go-modules --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/kubernetes-sigs/cloud-provider-azure.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/sync-go-modules .claude/skills/sync-go-modules && 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
sync-go-modules
GitHub stars
294
Token cost
~906 tokens
SKILL.md length
339 words
Files
3 (incl. scripts)
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Synchronize all tracked Go modules with the go-mod-consistency CI and refresh the root vendor tree.

  • Go-mod-consistency fails
  • SKILL.md covers When To Use, Workflow and Manual Fallback
  • Runs Python scripts from its folder; calls go, git and python3
  • Dependency bumps leave go.mod

What it does

Sync Go Modules is an agent skill from kubernetes-sigs/cloud-provider-azure, published by the product's own GitHub organization. Synchronize all tracked Go modules with the go-mod-consistency CI and refresh the root vendor tree. Use when go-mod-consistency fails, dependency bumps leave go.mod or go.sum stale, or the user asks to unblock module consistency, tidy all modules, or update vendor for the main module.

Its SKILL.md is about 910 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/sync_go_modules.py` and `scripts/test_sync_go_modules.py`).

It sits in DevOps & Cloud. It works with Go and Kubernetes. The repository describes itself as: Cloud provider for Azure. The licence is Apache-2.0.

When your agent uses it

  • Go-mod-consistency fails
  • Dependency bumps leave go.mod
  • The user asks to unblock module consistency
  • Tidy all modules

Example prompts

  • “/sync-go-modules”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit bac9134. 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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • go
    • git
    • python3
    • make

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Sync Go Modules loads about 906 tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 339 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from kubernetes-sigs/cloud-provider-azure at commit bac9134, republished under its Apache-2.0 licence (© kubernetes-sigs). 339 words, ~906 tokens.

Download SKILL.mdSave it as .claude/skills/sync-go-modules/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
sync-go-modules
description
Synchronize all tracked Go modules with the go-mod-consistency CI and refresh the root vendor tree. Use when go-mod-consistency fails, dependency bumps leave go.mod or go.sum stale, or the user asks to unblock module consistency, tidy all modules, or update vendor for the main module.

Sync Go Modules

When To Use

Use this skill when the go-mod-consistency workflow fails or when a dependency change needs repo-wide go.mod / go.sum reconciliation. The workflow mirrors .github/workflows/go-mod-consistency.yaml and .github/actions/discover-go-modules/action.yml, then also refreshes the main module's vendor/ tree.

Workflow

Replace <SKILL_DIR> with the path to this skill directory.

  1. Check for unrelated local work before mutating files:
bash
GIT_OPTIONAL_LOCKS=0 git status --short

If there are unrelated uncommitted changes, stop and report the conflict. If the existing changes are the module/dependency edits you are intentionally syncing, pass --allow-dirty to the helper.

  1. Run the sync from the repo root:
bash
python3 <SKILL_DIR>/scripts/sync_go_modules.py --repo .

For an intentionally dirty dependency branch:

bash
python3 <SKILL_DIR>/scripts/sync_go_modules.py --repo . --allow-dirty

The helper discovers modules with the same tracked-file pathspec as CI:

bash
GIT_OPTIONAL_LOCKS=0 git ls-files 'go.mod' '**/go.mod'

It then runs go mod tidy and go mod verify in every discovered module, with GOTOOLCHAIN=local so local behavior does not drift through automatic toolchain downloads.

  1. Keep the main module vendor tree in sync. This is enabled by default:
bash
(cd . && go mod vendor)

Use --skip-vendor only when the user explicitly asks to sync nested modules without touching root vendored dependencies.

  1. Inspect the generated diff:
bash
GIT_OPTIONAL_LOCKS=0 git diff --stat

Expected changes are scoped to tracked module files (go.mod / go.sum) and, when the root module changed, vendor/ plus vendor/modules.txt. If the vendor dependency set changed and the PR also needs license snapshots refreshed, rerun the helper with --update-vendor-licenses or run make update-vendor-licenses. That license update is adjacent to vendoring, but it is not part of the go-mod-consistency workflow itself.

  1. To check a clean branch the same way CI will, run the helper after committing or otherwise clearing the generated diff:
bash
python3 <SKILL_DIR>/scripts/sync_go_modules.py --repo . --check-clean

--check-clean fails if the sync produces any repository diff, matching the CI "Fail on uncommitted changes" step.

Helper-owned Git commands are read-only and run with GIT_OPTIONAL_LOCKS=0. This suppresses optional index refresh writes without weakening required locking for checkout, staging, commit, push, or ref-update operations performed outside this helper.

Manual Fallback

If the helper cannot be used, run the CI-equivalent loop manually:

bash
mapfile -t go_mods < <(GIT_OPTIONAL_LOCKS=0 git ls-files 'go.mod' '**/go.mod')
mapfile -t modules < <(for mod in "${go_mods[@]}"; do dirname "$mod"; done | sort -u)
for m in "${modules[@]}"; do
  echo ">> go mod tidy (${m})"
  (cd "${m}" && GOTOOLCHAIN=local go mod tidy)
  echo ">> go mod verify (${m})"
  (cd "${m}" && GOTOOLCHAIN=local go mod verify)
done
GOTOOLCHAIN=local go mod vendor
GIT_OPTIONAL_LOCKS=0 git diff --stat

Do not use find . -name go.mod for this repo. Hidden local worktrees and other untracked directories can contain extra modules that CI does not discover.

© kubernetes-sigs, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in .agents/skills/sync-go-modules of kubernetes-sigs/cloud-provider-azure.

  • SKILL.md
  • scripts/sync_go_modules.py
  • scripts/test_sync_go_modules.py

Open the folder on GitHubat commit bac9134

Compare with similar skills

Sync Go Modules 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.

Sync Go Modules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sync Go Modules this skillkubernetes-sigs/cloud-provider-azure294—~906Automated safety check: PassApache-2.0
NGINX Ingress Controller Feature Checklistsnginx/kubernetes-ingress5.1k—~1.4kAutomated safety check: PassApache-2.0
Bump Go Versionkubernetes-sigs/agent-sandbox4.2k—~1.1kAutomated safety check: PassApache-2.0
NGINX Ingress Policy CRD Guidenginx/kubernetes-ingress5.1k—~2kAutomated safety check: PassApache-2.0
Go Spec Reviewerinference-gateway/inference-gateway214—~1.2kAutomated safety check: PassApache-2.0
NGINX Ingress Controller Debuggingnginx/kubernetes-ingress5.1k—~1.7kAutomated safety check: PassApache-2.0

Similar skills

  • Gives step-by-step checklists for adding Ingress annotations, VirtualServer fields and Helm values to the NGINX Kubernetes Ingress Controller, with common gotchas.

    5.1k GitHub stars~1.4k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Bump Go Version

    kubernetes-sigs/agent-sandbox

    Official

    Bumps the Go version to the latest release across go.mod, tools.mod, and Dockerfiles.

    4.2k GitHub stars~1.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • NGINX Ingress Policy CRD Guide

    nginx/kubernetes-ingress

    Step-by-step checklist for adding a new Policy CRD type to the NGINX Ingress Controller, from the Go types and validation to config generation and templates.

    5.1k GitHub stars~2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Go Spec Reviewer

    inference-gateway/inference-gateway

    Review a Go design spec before implementation begins - dispatch a subagent that checks a design doc for completeness, consistency, and idiomatic Go (simplicity, small consumer-defined interfaces…

    214 GitHub stars~1.2k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • NGINX Ingress Controller Debugging

    nginx/kubernetes-ingress

    Troubleshooting patterns for the NGINX Ingress Controller: reload failures, custom resources that have no effect, controller panics and snapshot test failures.

    5.1k GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Educates Upgrade Go

    educates/educates-training-platform

    Upgrade the Go version across the entire educates-training-platform project.

    161 GitHub stars~1.4k tokensUpdated 4 days ago
    DevOps & CloudAuto-check: notes

More from kubernetes-sigs/cloud-provider-azure

All 12 skills in this repo
  • Run E2E Test

    kubernetes-sigs/cloud-provider-azure

    Official

    Parse a Go e2e test from tests/e2e/, translate each step to kubectl and az CLI commands, and interactively replay the test against a live cluster.

    294 GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Build Images

    kubernetes-sigs/cloud-provider-azure

    Official

    Build cloud-provider-azure container images through the repo Makefile with explicit IMAGETAG and IMAGEREGISTRY inputs, optional make flag overrides, and opt-in bounded Docker or Podman retries.

    294 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Cherry Pick PR

    kubernetes-sigs/cloud-provider-azure

    Official

    Cherry-pick a merged pull request onto a release branch with Prow-style branch naming, manual conflict resolution, targeted validation, and GitHub PR creation.

    294 GitHub stars~636 tokensUpdated today
    Auto-check passed
  • Create Release Note Doc PR

    kubernetes-sigs/cloud-provider-azure

    Official

    Generate or update the documentation-site release note for a given tag, commit it on a branch, push it to a writable remote, and open a GitHub PR to the docs branch.

    294 GitHub stars~768 tokensUpdated today
    Auto-check passed
  • Create Release Tags

    kubernetes-sigs/cloud-provider-azure

    Official

    Create and optionally push the next Kubernetes-style release tag (vX.Y.Z) from a release-X.Y branch by resolving the remote branch tip, computing the next patch tag, and tagging the commit directly…

    294 GitHub stars~574 tokensUpdated today
    Auto-check passed
  • Cve Remediator V2

    kubernetes-sigs/cloud-provider-azure

    Official

    Raise Go modules to caller-supplied minimum fixed versions from CVE/GO findings in any format, per tracked module root, sync go.mod/go.sum and root vendor/, audit the source module graphs, run the…

    294 GitHub stars~2.5k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Sync Go Modules

What does Sync Go Modules do?

Synchronize all tracked Go modules with the go-mod-consistency CI and refresh the root vendor tree. Sync Go Modules is an agent skill from kubernetes-sigs/cloud-provider-azure, published by the product's own GitHub organization. Synchronize all tracked Go modules with the go-mod-consistency CI and refresh the root vendor tree.

When should I use Sync Go Modules?

Sync Go Modules fits situations like: go-mod-consistency fails; dependency bumps leave go.mod; the user asks to unblock module consistency; tidy all modules.

How do I install Sync Go Modules in Claude Code?

Run `npx skills add kubernetes-sigs/cloud-provider-azure --skill sync-go-modules -a claude-code`. Or copy the skill folder (.agents/skills/sync-go-modules in kubernetes-sigs/cloud-provider-azure) into .claude/skills/sync-go-modules in your project. Claude Code loads it when a task matches its description.

How do I install Sync Go Modules in Codex?

Run `npx skills add kubernetes-sigs/cloud-provider-azure --skill sync-go-modules -a codex`. Or copy the skill folder (.agents/skills/sync-go-modules in kubernetes-sigs/cloud-provider-azure) into .agents/skills/sync-go-modules in your project. Codex loads it when a task matches its description.

Can I use Sync Go Modules 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 kubernetes-sigs/cloud-provider-azure --skill sync-go-modules -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sync-go-modules, .gemini/skills/sync-go-modules, .github/skills/sync-go-modules and .opencode/skills/sync-go-modules in your project.

What does Sync Go Modules need to run?

Going by SKILL.md and its folder, Sync Go Modules needs Python for the scripts in its folder and the command-line tools its instructions call (go, git, python3 and make). Our summary lists: Python 3.

Does Sync Go Modules access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Sync Go Modules 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Sync Go Modules use?

Sync Go Modules is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sync Go Modules use?

About 906 tokens (SKILL.md is roughly 3.6k 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 Sync Go Modules?

Skills that share tags, products or a category with Sync Go Modules: NGINX Ingress Controller Feature Checklists (nginx/kubernetes-ingress, 5.1k stars), Bump Go Version (kubernetes-sigs/agent-sandbox, 4.2k stars), NGINX Ingress Policy CRD Guide (nginx/kubernetes-ingress, 5.1k stars) and Go Spec Reviewer (inference-gateway/inference-gateway, 214 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sync Go Modules?

kubernetes-sigs (a GitHub organization, an official publisher) maintains it in kubernetes-sigs/cloud-provider-azure, which has 294 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 8, 2026.

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