git-ship

The git-ship skill is a comprehensive automation engine designed to streamline the software development lifecycle for teams using Git and GitHub. It acts as an orchestrator for standard version control operations, allowing developers to move from code implementation to a merged feature branch with minimal manual intervention. By wrapping complex command sequences—such as staging, committing, pushing, waiting for Continuous Integration (CI) status, and handling merge strategies—into simple, intent-based commands, it ensures consistency and speed in the development workflow.

• Full workflow automation: Executes the entire pipeline from git commit to branch merge in one integrated process.

• Conventional Commits enforcement: Validates that all commit messages follow structured semantic formatting, ensuring readable and auto-parsable project history.

• Intelligent CI integration: Automatically monitors CI checks and waits for pipeline completion, providing status feedback and error detection.

• Flexible merge strategies: Supports various strategies including squash, merge, and rebase, with options for auto-merge in protected environments.

• PR description scaffolding: Integrates with planning tools to generate structured and informative Pull Request descriptions automatically.

• Cleanup and maintenance: Automatically handles branch cleanup and status resolution post-merge to keep repositories organized.

• Best for feature branches requiring consistent PR hygiene and automated delivery pipeline execution.

• Requires GitHub CLI (gh) installed, authenticated, and configured for the repository to interface with GitHub APIs.

• Supports passing custom CI timeout values and merge strategy flags to handle diverse repository branch protection rules.

• Ideal for environments using git-worktree or parallel development workflows where quick, reliable shipping is required.

• Integration ready: Complements internal agent hooks like conventional-commits and the pr-comment-resolver for end-to-end development oversight.

• Designed for use in the 'Ship It' phase of AI-driven development workflows, reducing context switching during the deployment transition.