gh-tag

name	gh-tag
description	Create git tag. Use when creating version tags. Triggers on "tag", "打 tag", "gh-tag", "/gh-tag", "標記版本".
allowed-tools	Bash, Read, Grep
version	1.0.0
scope	public
evolution	{"enabled":true,"version":"1.0.0","stability":"stable","auto_evolve":"patch","created":"2026-02-17T00:00:00.000Z","updated":"2026-02-17T00:00:00.000Z","history":[{"version":"1.0.0","date":"2026-02-17","note":"Initial version"}]}

GH Tag

Create a git tag, automatically reading the version number from project config files.

---

Integrations

upstream:
  - skill: gh-commit
    receives: Committed commits

downstream:
  - skill: gh-push
    produces: Tag that needs to be pushed
  - skill: gh-release
    produces: Tag that can be used to create a release

---

Out of Scope

• Push tag to remote - Use gh-push or push manually
• Create Release - Use gh-release
• Signed tags - Requires GPG setup, not handled automatically

---

When to Use

• Version is ready to be tagged
• Completed a milestone that needs a tag
• User requests tagging

---

Workflow

Phase 1: Detect Version Number

1. Read version from project config files

   Try in order:

   File	Method
   package.json	.version
   Cargo.toml	version = "x.y.z"
   tauri.conf.json	"version": "x.y.z"
   pyproject.toml	version = "x.y.z"
   pubspec.yaml	version:

   # Example: read from package.json
   grep '"version"' package.json | head -1
   

2. Check if tag already exists

   git tag -l "v*" | sort -V | tail -5
   

   • If v{version} already exists, notify the user and stop
   • Display the 5 most recent tags for reference

Phase 2: Confirmation

3. Display summary
   • Tag to be created: v{version}
   • Current HEAD commit: git log -1 --oneline
   • Most recent tag: from the query above

Phase 3: Create Tag

4. Create lightweight tag

   git tag v{version}
   

5. Verify

   git tag -l "v{version}"
   

6. Suggest next steps

   • Need to push: git push origin v{version} or use gh-push
   • Need a release: use gh-release

---

Safety and Escalation

Situation	Action
Tag already exists	Notify user, do not overwrite
Version number not found	Ask user to provide manually
Uncommitted changes exist	Warn, suggest committing first
Working tree dirty	Show git status, let user decide

---

Verification

# Confirm tag has been created
git tag -l "v*" | sort -V | tail -3

# Confirm tag points to the correct commit
git log -1 --oneline v{version}