Skip to content
Agentic Coding Toolkit

Git Skills

ACT git skills are optional helpers for common repository chores. They are not part of the core ACT workflow, and ACT does not automatically create branches, commits, pull requests, or merges for you.

They cover conventional commits, PR creation with smart descriptions, and git worktree support for isolated parallel feature development.

Use these skills when you want the agent to help with a specific git task. Keep using manual git commands or your GitHub UI when you want tighter control.

/act-git-commit

Section titled “/act-git-commit”

Create a conventional commit for staged changes only.

Terminal window
/act-git-commit

ACT analyzes your staged changes and generates a conventional commit message.

/act-git-commit-all

Section titled “/act-git-commit-all”

Create a conventional commit for all changes.

Terminal window
/act-git-commit-all

This stages everything first, then commits.

/act-git-push-make-pr

Section titled “/act-git-push-make-pr”

Push the current branch to GitHub and create a pull request.

Terminal window
/act-git-push-make-pr

This skill:

  1. Checks for uncommitted changes
  2. Pushes the branch
  3. Checks for an existing PR
  4. Looks for matching workflow context
  5. Generates a PR title and summary
  6. Creates the PR with gh pr create

/act-git-switch-main-pull

Section titled “/act-git-switch-main-pull”

Switch to the main branch and pull the latest changes.

Terminal window
/act-git-switch-main-pull

Use this to get back to a clean main branch after finishing a feature.

/act-git-worktree

Section titled “/act-git-worktree”

Manage git worktrees for isolated parallel feature development.

Terminal window
/act-git-worktree [action]

Typical actions include creating, listing, switching, copying .env, deleting, and cleaning up worktrees.

When creating a worktree or copying env files, the skill also symlinks agent instruction files like CLAUDE.md and AGENTS.md (if they are gitignored) from the main checkout, so local agent context carries over to each worktree automatically.

Typical workflow

Section titled “Typical workflow”
Terminal window
# 1. Interview session
/act-interview "add authentication"
/act-create-spec
# commit manually or use /act-git-commit-all


# 2. Create Work Items
/new
/act-create-issues ai_specs/0001-auth/spec.md
# commit manually or use /act-git-commit-all


# 3. Implement first Work Item
/new
/act-implement ai_specs/0001-auth/work-items/01-email-sign-in.md
# act-implement is the only skill that auto-commits


# Repeat step 3 for each Work Item


# 4. Review the code, then:
/act-git-push-make-pr


# 4. Optional: after PR is merged, get back to main
/act-git-switch-main-pull
Section titled “Related”