Shipping Git
Developmentshipping-gitShipping Git is an Agent Skill for development published in the anza-xyz/kit repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Shipping workflow using standard Git and GitHub CLI. Provides guidance for committing, branching, and creating PRs.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/anza-xyz/kit/blob/HEAD/.agents/skills/shipping-git/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/shipping-git, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Ship Code Using Git
Guidance for shipping code using standard Git and the GitHub CLI (gh). This skill teaches the agent how to create commits, branches, and pull requests following conventional workflows.
Key Rules
- NEVER commit, push, create branches, or create PRs without explicit user approval.
- Before any git operation that creates or modifies a commit, present a review block containing: changeset content (if applicable), commit title, and commit/PR description. ALWAYS wait for approval.
- Show the proposed changeset entry for review before writing the changeset file.
- Use standard
git addandgit commitworkflows. Concise title on the first line, blank line, then description body. - Use
gh pr createfor pull requests. - Write commit and PR descriptions as natural flowing prose. Do NOT insert hard line breaks mid-paragraph.
Guidelines
Creating Commits
Follow conventional commit message format:
git add -A
git commit -m "Commit title" -m "Description body explaining what changed and why."
- The first
-msets the commit title (first line). Keep it concise and descriptive. - The second
-msets the commit body. Explain what changed and why. - Use present tense, imperative mood (e.g. "Add feature" not "Added feature").
Creating Branches
Create a descriptive branch name before committing:
git checkout -b feature/short-description
Common prefixes: feature/, fix/, refactor/, docs/, chore/.
Creating Pull Requests
Use the GitHub CLI to create PRs:
gh pr create --title "PR title" --body "Description explaining what changed and why."
- If a
.github/PULL_REQUEST_TEMPLATE.mdexists, use it as a guide for structuring the PR description. Fill in sections that are relevant and omit sections that don't apply (e.g. don't add "Fixes #" if there's no related issue).
Pushing Changes
Push the branch and set the upstream:
git push -u origin HEAD
Review Block Format
Before any git operation, present this review block and wait for approval:
- Changeset entry (if applicable) — the proposed changelog entry and bump type.
- Commit title — a concise title for the commit.
- Commit/PR description — a short description that explains what changed and why.