chsh-sk-ncs-git-release

Automates git tagging, CI monitoring, and GitHub Release publishing for NCS firmware projects.

1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/chshzh/claude --skill chsh-sk-ncs-git-release-chshzh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chsh-sk-ncs-git-release
Source: https://github.com/chshzh/claude/tree/main/skills/chsh-sk-ncs-git-release
Command: npx skills add https://github.com/chshzh/claude --skill chsh-sk-ncs-git-release-chshzh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Releasing NCS firmware involves a fragile chain of git tagging, GitHub Actions CI, artifact naming, and release publishing where one misstep produces broken or missing .hex artifacts. This Skill provides a repeatable, verified release workflow with built-in failure recovery. ## Core Features & Use Cases - Release Tagging: Decide between version tags, patch bumps, rolling releases, and pre-releases, then create and push annotated git tags. - CI Monitoring & Debugging: Watch GitHub Actions runs with gh CLI, inspect failed step logs, and apply fixes from a table of common CI failures. - Release Publishing: Create or update GitHub Releases, upload .hex firmware artifacts, and manage stale assets. - Use Case: After finishing a feature on an nRF Connect SDK project, tag v1.2.0, watch the CI build, and publish the merged.hex artifact to a GitHub Release without manually juggling gh commands. ## Quick Start Ask Claude to tag a new release for your NCS app and watch the CI run until the firmware artifact is published to GitHub.

Frequently Asked Questions about chsh-sk-ncs-git-release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I tag and publish a firmware release on GitHub?▼

Create an annotated git tag with git tag -a v<version> -m, push it, then monitor the GitHub Actions run with gh run watch. If CI does not auto-release, use gh release create with the built .hex artifact attached.

How do I watch GitHub Actions CI runs from the command line?▼

Use gh run list to see recent runs and gh run watch <run-id> --interval 30 for live updates. On failure, run gh run view <run-id> --log-failed to get the failing step logs.

Why does my GitHub Actions firmware build fail with merged.hex not found?▼

The merged.hex file is only produced when MCUboot sysbuild is enabled. Fall back to zephyr/zephyr.hex or check your sysbuild.conf configuration to enable the merged output.

Should I re-tag when a release CI run fails?▼

No. Fix the underlying issue, push the commit, and watch the new run. Only re-tag if the previous tag itself was wrong, since re-tagging creates confusion about which commit a version points to.

When should I use a rolling release instead of a version tag?▼

Use a rolling release for nightly or continuous builds by pushing to main and letting CI overwrite the latest release. Use annotated version tags for stable feature releases, bug fixes, and pre-releases like v1.2.0-rc1.