Skills
Skill 2 of 54
Upgrade gh-aw to latest gh-aw-firewall release and identify follow-up spec tasks.
2 minutes · 388 words · 6 sections
Install
npx skills add github/gh-aw --skill awf-release-integratornpx skills add github/gh-awThe first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.
Use this skill when updating github/gh-aw to a newer github/gh-aw-firewall release.
Land the version bump cleanly, rebuild the generated artifacts, and review upstream release/spec changes for any follow-up work that should accompany the bump.
Consult these sources before editing anything:
github/gh-aw-firewall release metadata and body.pkg/constants/version_constants.go.specs/awf-config-sources-spec.md.pkg/workflow/schemas/awf-config.schema.json.pkg/workflow/awf_config.gopkg/workflow/awf_config_build.gopkg/workflow/awf_config_schema.gopkg/workflow/awf_config_policy.gopkg/workflow/awf_helpers.gopkg/workflow/For upstream spec review, compare these files from the target github/gh-aw-firewall release or tag:
docs/awf-config-spec.mddocs/awf-config.schema.jsonsrc/awf-config-schema.jsonawf-config.schema.jsonpkg/constants/version_constants.go and record:
DefaultFirewallVersionAWF*MinVersion constantgithub/gh-aw-firewall release.DefaultFirewallVersion, report that no version bump is needed and only continue with spec/release-note review if explicitly requested.DefaultFirewallVersionAWF*MinVersion constants that must move because the new release introduces or changes gated flags/featurespkg/workflow/schemas/awf-config.schema.jsonspecs/awf-config-sources-spec.mdAfter editing, run the full AWF rebuild flow exactly in this order. The second
make recompile is required to refresh image SHA pins resolved during the first pass.
make build
make recompile
make recompileThen run focused validation for any touched Go code or schema logic, especially AWF-related tests.
Summarize:
When deciding whether more than a version bump is needed, specifically check for:
AWF*MinVersion gatesspecs/awf-config-sources-spec.mdmain, last pushed 24 September 2026.SKILL.md, not by matching a directory convention. 4 distinct layouts observed: .claude/skills/*/SKILL.md, .github/skills/*/SKILL.md, .squad/*/skill.md, SKILL.md (repo root).h1 and no skipped levels:/github/gh-aw.md, and each skill at its own .md URL.