HuyTinh/git-release-bundler / skills/git-mark
git-mark
VerifiedMark the current or specified Git branch for local release bundling (.git/marked_branches.txt). Triggered when the user invokes /git-mark, /mark, /git-mark list, /mark list, /git-mark clear, /mark clear, /git-mark unmark <branch>, or says "mark nhánh này", "đánh dấu nhánh", "bỏ đánh dấu nhánh".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.2 KB |
| scripts/mark.ps1 | script | 4.2 KB |
| scripts/mark.py | script | 4.9 KB |
scripts/mark.py
View on GitHub#!/usr/bin/env python3
"""
git-mark: Mark Git branches for local release bundling.
Zero dependencies (Standard Library only). Cross-platform (Windows, macOS, Linux).
"""
from __future__ import annotations
import sys
import subprocess
from pathlib import Path
def run_git(args: list[str]) -> tuple[int, str]:
try:
proc = subprocess.run(
["git"] + args,
capture_output=True,
text=True,
encoding="utf-8",
errors="replace"
)
return proc.returncode, proc.stdout.strip()
except Exception as e:
return 1, str(e)
def main():
# 1. Verify Git repository (Item 8)
code, git_root = run_git(["rev-parse", "--show-toplevel"])
if code != 0 or not git_root:
print("[ERROR] Current directory is not a Git repository.", file=sys.stderr)
sys.exit(1)
code, git_dir = run_git(["rev-parse", "--git-dir"])
if code != 0 or not git_dir:
git_dir = ".git"
marked_file = (Path(git_root) / git_dir / "marked_branches.txt").resolve()
args = sys.argv[1:]
action_or_branch = args[0].strip() if len(args) > 0 else ""
target_branch = args[1].strip() if len(args) > 1 else ""
# 2. Action: list
if action_or_branch in ["list", "-l", "--list"]:
if marked_file.exists():
lines = [
line.strip()
for line in marked_file.read_text(encoding="utf-8").splitlines()
if line.strip()
]
if lines:
print(f"\nMarked branches awaiting release ({len(lines)} branches):")
for i, b in enumerate(lines, 1):
print(f" {i:2}. {b}")
print()
else:
print("No branches currently marked.")
else:
print("No branches currently marked.")
sys.exit(0)
# 3. Action: clear
if action_or_branch in ["clear", "-c", "--clear"]:
if marked_file.exists():
marked_file.unlink(missing_ok=True)
print("[OK] Cleared all marked branches.")
sys.exit(0)
# 4. Action: unmark / rm
if action_or_branch in ["unmark", "rm", "remove", "-d", "--delete"]:
branch_to_remove = target_branch
if not branch_to_remove:
_, branch_to_remove = run_git(["branch", "--show-current"])
branch_to_remove = branch_to_remove.strip()
if marked_file.exists():
lines = [
line.strip()
for line in marked_file.read_text(encoding="utf-8").splitlines()
if line.strip()
]
if branch_to_remove in lines:
updated = [b for b in lines if b != branch_to_remove]
if updated:
with open(marked_file, "w", encoding="utf-8", newline="\n") as f:
f.write("\n".join(updated) + "\n")
else:
marked_file.unlink(missing_ok=True)
print(f"[OK] Unmarked branch '{branch_to_remove}' ({len(updated)} branches remaining).")
sys.exit(0)
else:
print(f"[WARN] Branch '{branch_to_remove}' was not found in the marked list.", file=sys.stderr)
sys.exit(2)
else:
print("[WARN] No branches currently marked.", file=sys.stderr)
sys.exit(2)
# 5. Action: default mark
branch_to_mark = action_or_branch
if not branch_to_mark:
_, branch_to_mark = run_git(["branch", "--show-current"])
branch_to_mark = branch_to_mark.strip()
if not branch_to_mark:
print("[ERROR] Could not determine current branch. Please specify branch name (e.g. git mark feat/order).", file=sys.stderr)
sys.exit(1)
# Typo check: warn if marking an explicit branch that doesn't exist locally or on origin
_, current_branch = run_git(["branch", "--show-current"])
if branch_to_mark != current_branch:
code_local, _ = run_git(["rev-parse", "--verify", "--quiet", branch_to_mark])
if code_local != 0:
code_remote, _ = run_git(["rev-parse", "--verify", "--quiet", f"origin/{branch_to_mark}"])
if code_remote != 0:
print(f"[WARNING] Branch '{branch_to_mark}' does not exist in local or remote Git. Please verify spelling.")
existing = []
if marked_file.exists():
existing = [
line.strip()
for line in marked_file.read_text(encoding="utf-8").splitlines()
if line.strip()
]
if branch_to_mark in existing:
print(f"[INFO] Branch '{branch_to_mark}' is already marked ({len(existing)} branches waiting).")
else:
existing.append(branch_to_mark)
with open(marked_file, "w", encoding="utf-8", newline="\n") as f:
f.write("\n".join(existing) + "\n")
print(f"[OK] Marked branch: {branch_to_mark} (Total: {len(existing)} branches waiting).")
sys.exit(0)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |