What problem does it solve?
Manually pushing branches and writing pull request descriptions is time-consuming, often inconsistent, and fails to capture the intent behind code changes, leading to unclear review context for collaborators.
Core Features & Use Cases
- Pre-flight Safety Checks: Validates GitHub authentication, branch state, and commit history before any push to avoid broken or accidental changes.
- Intent-Driven PR Generation: Automatically creates PR titles and bodies from branch names and commit history, focusing on the purpose of changes rather than just listing modified files.
- Stacked PR Support: Detects PR stacks and optionally includes a stack section in the PR body for linked, dependent changes.
- Label Management: Maps branch prefixes to repository labels and auto-creates missing labels if approved by the user.
- Existing PR Updates: Handles updates to open PRs with options to overwrite, append, or skip body updates when new commits are pushed.
Use case: For example, after finishing a feature branch for user migration, this skill automates the entire push and PR creation process, generating a clear description that explains the migration's business purpose instead of listing every modified file.
Quick Start
Use the ship skill to push my current feature branch and create a pull request with a clear description of the changes.