Agent skill

Go Upgrade

by straubt1 in straubt1/tfx

Upgrade macOS Go and all module dependencies in TFx via task go:upgrade, then verify build and tests.

MITAuto-check: notesDevelopment

Install Go Upgrade

skills CLI
$ npx skills add straubt1/tfx --skill go-upgrade -a claude-code

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

GitHub CLI
$ gh skill install straubt1/tfx go-upgrade --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/straubt1/tfx.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/go-upgrade .claude/skills/go-upgrade && 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
go-upgrade
GitHub stars
110
Token cost
~914 tokens
SKILL.md length
402 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Upgrade macOS Go and all module dependencies in TFx via task go:upgrade, then verify build and tests.

  • Works in 3 steps: Read the top of CHANGELOG.md and look… → If it exists: add a bullet under Changed… → If it does not exist: insert a new…
  • The user asks to upgrade Go
  • SKILL.md covers Prerequisites, Upgrade, Verify and Changelog, plus 3 more sections
  • Calls go, git and brew

What it does

Go Upgrade is an agent skill from straubt1/tfx. Upgrade macOS Go and all module dependencies in TFx via task go:upgrade, then verify build and tests. Use when the user asks to upgrade Go, update dependencies, bump go.mod, or refresh packages.

Its SKILL.md is about 910 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 Development. It works with Go, macOS, Git and Homebrew. The repository describes itself as: TFx is a standalone CLI for HCP Terraform and Terraform Enterprise. The licence is MIT.

When your agent uses it

  • The user asks to upgrade Go
  • Update dependencies
  • Refresh packages

Example prompts

  • “/go-upgrade”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Read the top of CHANGELOG.md and look for a section matching ## [vX.Y.Z] - Unreleased.
  2. If it exists: add a bullet under Changed (create a Changed subsection if missing)
  3. If it does not exist: insert a new unreleased section immediately after the Keep a Changelog intro (before the first dated release)…

What it can do on your machine

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

    • go
    • git
    • brew
    • gh

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

  • Network

    Links to these hosts (documentation or services it may open):

    • keepachangelog.com

    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

Go Upgrade loads about 914 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 402 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:50
    out of scope unless requested (`secrets/.env-int` required):

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 straubt1/tfx at commit f7494e5, republished under its MIT licence (© straubt1). 402 words, ~914 tokens.

Download SKILL.mdSave it as .claude/skills/go-upgrade/SKILL.md (or your agent's skills folder).
name
go-upgrade
description
Upgrade macOS Go and all module dependencies in TFx via task go:upgrade, then verify build and tests. Use when the user asks to upgrade Go, update dependencies, bump go.mod, or refresh packages.
disable-model-invocation
true

Go Upgrade

Upgrade the local Go toolchain and all module dependencies, then verify the repo still builds and tests pass.

Prerequisites

  • macOS with Homebrew
  • Run from repo root
  • If tools may be missing: task development:doctor (install with brew install go goreleaser go-task)

Upgrade

Run the Taskfile task (see DEVELOPMENT.md § Upgrading Dependencies):

bash
task go:upgrade

This upgrades go and goreleaser via Homebrew, syncs go.mod to the installed Go version, runs go get -u ./..., go mod tidy, and updates the README Go version badge.

Files touched: go.mod, go.sum, README.md (badge only), CHANGELOG.md. CI reads Go version from go.mod via go-version-file.

If brew upgrade go reports already latest, the task still refreshes module dependencies.

Verify

Match CI (.github/workflows/build.yml):

bash
go build ./...
go test ./...

Some client/ tests call the TFE API — run with network access if the sandbox blocks them.

On failure: diagnose and fix compile or test issues from breaking dependency bumps. Do not downgrade Go without asking the user.

Optional smoke check:

bash
task go:build && ./tfx version

Integration tests are out of scope unless requested (secrets/.env-int required):

bash
task test:integration-data
task test:integration-cmd

Changelog

Update CHANGELOG.md after a successful upgrade. This repo uses Keep a Changelog with unreleased sections titled ## [vX.Y.Z] - Unreleased (not a bare [Unreleased] heading).

  1. Read the top of CHANGELOG.md and look for a section matching ## [vX.Y.Z] - Unreleased.

  2. If it exists: add a bullet under Changed (create a **Changed** subsection if missing):

    * Upgraded Go to X.Y.Z and refreshed module dependencies

    Replace X.Y.Z with the version from go version. Do not duplicate the entry if an equivalent bullet is already present.

  3. If it does not exist: insert a new unreleased section immediately after the Keep a Changelog intro (before the first dated release). Derive the version label from the latest git tag:

    bash
    git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*"

    Bump the patch segment (e.g. v0.3.3 → v0.3.4) and add:

    markdown
    ## [v0.3.4] - Unreleased
    
    **Changed**
    
    * Upgraded Go to X.Y.Z and refreshed module dependencies
Show full SKILL.md (126 more words)Show less

Report

  1. Show git diff --stat for go.mod, go.sum, README.md, and CHANGELOG.md
  2. Draft commit message (do not commit unless asked):
chore: upgrade Go to X.Y.Z and refresh module dependencies

Replace X.Y.Z with the version from go version.

Default: stop before git

Do not create a branch, commit, or open a PR unless the user explicitly asks.

Optional: branch, commit, and PR

When the user asks to commit and/or open a PR (e.g. "upgrade go and open a PR"):

  1. Create branch: git checkout -b chore/go-upgrade-<version>
  2. Stage only: go.mod, go.sum, README.md, CHANGELOG.md
  3. Commit with HEREDOC message (use draft above)
  4. Push: git push -u origin HEAD
  5. Open PR: gh pr create with Summary and Test plan (note local go build ./... and go test ./... passed)

Do not push or commit unless explicitly requested.

© straubt1, 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 .cursor/skills/go-upgrade of straubt1/tfx.

Open the folder on GitHubat commit f7494e5

Compare with similar skills

Go Upgrade 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.

Go Upgrade compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Go Upgrade this skillstraubt1/tfx110—~914Automated safety check: NotesMIT
Releasevaayne/mori303—~1.2kAutomated safety check: PassMIT
Install Mimi Remotegaixianggeng/mimi-remote104—~2.8kAutomated safety check: PassGPL-3.0
Build Afmscouzi1966/maclocal-api346—~1.8kAutomated safety check: NotesMIT
Mole CLI Release Flowtw93/Mole70k—~2.6kAutomated safety check: PassGPL-3.0
Go-Redis Release Preparationredis/go-redis22k—~1.1kAutomated safety check: PassBSD-2-Clause

Similar skills

  • Release

    vaayne/mori

    Release workflow for Mori macOS workspace terminal and MoriRemote iOS app.

    303 GitHub stars~1.2k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Install Mimi Remote

    gaixianggeng/mimi-remote

    安装、配置、配对、迁移、升级、诊断、回滚或卸载 Mimi Remote;在 macOS 上安装和维护 Mimi Remote Mac 菜单栏 App / DMG,或通过 Homebrew、Linux user-systemd 部署 agentd;从源码构建 iPhone/iPad App;配置 Codex 主通道和可选 Claude Code 实验 Runtime。用户提出“安装 Mimi…

    104 GitHub stars~2.8k tokensUpdated today
    MobileAuto-check passed
  • Build Afm

    scouzi1966/maclocal-api

    Build AFM from scratch — submodules, patches, webui, and Swift build.

    346 GitHub stars~1.8k tokensUpdated today
    MobileAuto-check: notes
  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Official

    Prepares a go-redis release locally: picks the next semver, gathers merged PRs, writes the RELEASE-NOTES entry and bumps versions, without publishing.

    22k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Code Review

    yaklang/yakit

    对 Yakit 仓库的代码改动做规范化 code review:按代码逻辑、TS 定义、UI 引用与 Props、CSS 样式、依赖版本、配置项六个维度审查,检查测试用例缺失,强制执行 tsc 类型检查与 vitest 测试验证,输出「结果汇总 / 明细解释 / 合并结论」三块报告,经用户确认后写入文件。当用户要求 review、审查、评审代码改动,或在提交、合并、提 PR…

    7.8k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check: notes

More from straubt1/tfx

  • Reflection

    straubt1/tfx

    This skill should be used when the user says "reflection", "reflect on the changes", "reflect on this session", or asks to capture lessons learned from the current conversation.

    110 GitHub stars~793 tokensUpdated 1 mo ago
    Auto-check passed
  • Release

    straubt1/tfx

    Prepare and cut TFx semver releases (CHANGELOG, validation, tagging via Taskfile).

    110 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Vhs Tape

    straubt1/tfx

    Create a VHS .tape file for recording terminal GIF/MP4/WebM demos.

    110 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • New Data Function

    straubt1/tfx

    Create a new function in the data/ package following project conventions

    110 GitHub stars~976 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Go Upgrade

What does Go Upgrade do?

Upgrade macOS Go and all module dependencies in TFx via task go:upgrade, then verify build and tests. Go Upgrade is an agent skill from straubt1/tfx. Upgrade macOS Go and all module dependencies in TFx via task go:upgrade, then verify build and tests.

When should I use Go Upgrade?

Go Upgrade fits situations like: the user asks to upgrade Go; update dependencies; refresh packages.

How do I install Go Upgrade in Claude Code?

Run `npx skills add straubt1/tfx --skill go-upgrade -a claude-code`. Or copy the skill folder (.cursor/skills/go-upgrade in straubt1/tfx) into .claude/skills/go-upgrade in your project. Claude Code loads it when a task matches its description.

How do I install Go Upgrade in Codex?

Run `npx skills add straubt1/tfx --skill go-upgrade -a codex`. Or copy the skill folder (.cursor/skills/go-upgrade in straubt1/tfx) into .agents/skills/go-upgrade in your project. Codex loads it when a task matches its description.

Can I use Go Upgrade 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 straubt1/tfx --skill go-upgrade -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/go-upgrade, .gemini/skills/go-upgrade, .github/skills/go-upgrade and .opencode/skills/go-upgrade in your project.

What does Go Upgrade need to run?

Going by SKILL.md and its folder, Go Upgrade needs the command-line tools its instructions call (go, git, brew and gh).

Does Go Upgrade access the network?

SKILL.md names 1 domain. As links in the text: keepachangelog.com. This is read from the text; nothing was executed.

Is Go Upgrade safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Go Upgrade use?

Go Upgrade 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 Go Upgrade use?

About 914 tokens (SKILL.md is roughly 3.7k 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 Go Upgrade?

Skills that share tags, products or a category with Go Upgrade: Release (vaayne/mori, 303 stars), Install Mimi Remote (gaixianggeng/mimi-remote, 104 stars), Build Afm (scouzi1966/maclocal-api, 346 stars) and Mole CLI Release Flow (tw93/Mole, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Go Upgrade?

straubt1 (a GitHub user) maintains it in straubt1/tfx, which has 110 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on August 28, 2026.

Source: straubt1/tfx on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.