agentic-genomics: Skill for Claude Code

Git Workflow Skill

Commit Policy

Do NOT git commit or git push unless (a) the user explicitly directs it, or (b) it is a defined step in the approved plan/task. Never auto-commit at the end of a correction cycle or verification pass.

The One Rule

Run the script. Don't improvise git commands.

# // turbo
pwsh -File .agent/skills/git-workflow/scripts/agent-commit.ps1 -Message "feat: description"

The script validates signing config, stages, commits, pushes, and verifies — all in one command. If you skip the script, you WILL cause a hang.

Agent invocation rules:

• Set WaitMsBeforeAsync to 30000 (push can take 10-20s on large changesets)
• If the command goes to background anyway, do NOT poll command_status — run git log --oneline -1 directly to verify
• Never issue more than one command_status check; if it shows no output, the command finished and output was lost — verify the result instead

Script Usage

# Basic commit + push to main
# // turbo
pwsh -File .agent/skills/git-workflow/scripts/agent-commit.ps1 -Message "feat: add new feature"

# With body text
# // turbo
pwsh -File .agent/skills/git-workflow/scripts/agent-commit.ps1 -Message "feat: add feature" -Body "Detailed description here"

# Push to a different branch
# // turbo
pwsh -File .agent/skills/git-workflow/scripts/agent-commit.ps1 -Message "fix: correct bug" -Branch "dev"

# Commit without pushing
# // turbo
pwsh -File .agent/skills/git-workflow/scripts/agent-commit.ps1 -Message "wip: save progress" -Push $false

What the Script Does (Do NOT Do These Manually)

1. ✅ Validates SSH signing config (fails fast if GPG would hang)
2. ✅ Checks remote URL format (warns on HTTPS)
3. ✅ Stages all changes (git add -A)
4. ✅ Commits with -m flag (never opens editor)
5. ✅ Pushes to origin (unless -Push $false)
6. ✅ Verifies with git log --oneline -1

[!WARNING] --no-verify is a last resort. It skips ALL pre-commit hooks — not just gitleaks, but also JSON/YAML validation, private-key detection, and whitespace fixes. Use only when:

1. Commits hang due to gitleaks scanning large binary files
2. You have verified the staged files don't contain secrets

After a --no-verify commit, manually run pre-commit run --all-files to catch anything skipped.