che-ship

Executes five quality gates then commits, pushes, and opens a draft GitHub PR.

Updated May 12, 2026
One-click install
npx skills add https://github.com/laionazeredo/che-ai --skill che-ship-laionazeredo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: che-ship
Source: https://github.com/laionazeredo/che-ai/tree/main/skills/che-ship
Command: npx skills add https://github.com/laionazeredo/che-ai --skill che-ship-laionazeredo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Shipping code safely at the end of a task requires running scope validation, code review, compliance scanning, and QA before any git operation — a process that is easy to skip or do inconsistently. This Skill enforces that entire pre-ship pipeline as executable fail-fast gates, then handles the commit, push, and draft PR creation automatically. ## Core Features & Use Cases - Five Executable Quality Gates: Runs scope-checker (delivery + LEAN 6-checks, score ≥7.0), code review with auto-remediation of ≤2 HIGH findings, a heavy full-repo compliance scan (0 CRITICAL / 0 HIGH), a QA gate with minimal/normal/full profiles, and optional domain-specific gates for non-engineering work. - Safe Git Workflow: Verifies worktree session binding, blocks planning artifacts from entering commits, creates atomic conventional commits, pushes, and opens a structured DRAFT PR assigned to the user. - gh-stack Support: Detects approved hierarchical PR stack plans and ships multi-layer partial deliveries as stacked PRs bottom-up. - Use Case: After finishing all tasks in a worktree, run the ship command to have every gate verified, small review findings auto-fixed and committed, and a draft PR opened against the default branch with a readable description. ## Quick Start Run /che-ship after all tasks are marked DONE in the worktree to execute the quality gates and open a draft PR.

Frequently Asked Questions about che-ship

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ship code and open a draft PR after finishing a task?▼

Run /che-ship once all tasks are marked DONE in the worktree. It executes the scope, code review, compliance, and QA gates first, then creates atomic conventional commits, pushes the branch, and opens a draft PR against the default branch assigned to you.

What quality gates run before a commit in the ship workflow?▼

Five gates run in fail-fast order: scope-checker 6-checks (score ≥7.0), code review Mode B, a heavy full-repo compliance scan requiring 0 CRITICAL and 0 HIGH, a QA gate with minimal/normal/full profiles, and optional domain gates for non-engineering work.

Does the ship gate auto-fix code review findings?▼

Yes, but only when there are 0 CRITICAL and at most 2 HIGH findings. Auto-fixable HIGH findings are applied and committed with a conventional fix commit without asking the user. CRITICAL findings or 3+ HIGH findings block the ship and require manual fixes or logged overrides.

Can I skip the QA gate when shipping?▼

Only by passing --skip-qa together with an explicit written justification that is recorded in the decision log as an EXPLICIT_OVERRIDE entry. Without that logged override, the ship is blocked; there is no silent bypass path.

Does che-ship support stacked or multi-layer pull requests?▼

Yes. If an approved gh_stack_plan.md exists in the shared workspace and the gh-stack extension is installed, it ships layers bottom-up as a hierarchical PR stack. Otherwise it falls back to the standard single-PR path.

Why does the ship command block with a worktree binding error?▼

Ship requires a Level 1 session-to-worktree binding in the global registry, and the bound worktree must match the one being shipped. A mismatch or missing binding blocks the ship to prevent committing to the wrong worktree; you must confirm or rebind before continuing.