commit 71e05c68409b77e5cec5a92fdabd187f6749acc7
Author: Ben Sima <ben@bensima.com>
Date: Thu Jan 1 13:06:11 2026
Add git-workflow skill (t-323)
Documents git-branchless workflow: smartlog, amend, move, restack.
Includes commit message format and pre-commit checklist.
Task-Id: t-323
diff --git a/Omni/Agent/Skills/shared/git-workflow/SKILL.md b/Omni/Agent/Skills/shared/git-workflow/SKILL.md
new file mode 100644
index 00000000..a2957844
--- /dev/null
+++ b/Omni/Agent/Skills/shared/git-workflow/SKILL.md
@@ -0,0 +1,71 @@
+---
+name: git-workflow
+description: Git operations for the omnirepo using git-branchless. Use when committing, branching, or managing changes.
+---
+
+# Git Workflow
+
+This repo uses **git-branchless** for a patch-based workflow.
+
+## Key Commands
+
+### View commit graph
+```bash
+git smartlog
+```
+
+### Create a commit
+```bash
+git add -A
+git commit -m "Namespace: Short description" --no-verify --no-gpg-sign
+```
+
+### Amend current commit
+```bash
+git add -A
+git amend
+```
+
+### Move/restack commits
+```bash
+git move -s <source> -d <destination>
+git restack
+```
+
+## Commit Message Format
+
+```
+Namespace: Short description (max 72 chars)
+
+Longer explanation if needed. Explain why, not just what.
+
+Task-Id: t-123
+```
+
+Example:
+```
+Omni/Task: Add --namespace flag to create command
+
+Allows associating tasks with specific code namespaces for
+better organization and filtering.
+
+Task-Id: t-456
+```
+
+## Before Committing
+
+Always run:
+```bash
+bild --test <namespace>
+lint <file>
+```
+
+Fix all errors before committing.
+
+## What NOT to Do
+
+- ❌ `git push` without explicit user request
+- ❌ `git pull` without explicit user request
+- ❌ Force pushes or destructive operations
+- ❌ Large commits mixing unrelated changes
+- ❌ Committing without running bild first