shipping

Coordinate green code changes through verification, PR creation, and CI recovery in GitHub workflows.

Updated May 17, 2022
One-click install
npx skills add https://github.com/kanade0404/dotfiles --skill shipping-kanade0404
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shipping
Source: https://github.com/kanade0404/dotfiles/tree/main/.opencode/skills/shipping
Command: npx skills add https://github.com/kanade0404/dotfiles --skill shipping-kanade0404

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It handles the final stage after implementation is already green, so code can move from local completion to a merge-ready pull request without manual orchestration.

Core Features & Use Cases

  • Quality Gate Coordination: Runs simplification and code review before any release steps continue.
  • Verification and PR Materialization: Checks done criteria, creates or reuses a PR, and ensures the branch is ready for review.
  • CI and Review Convergence: Repeatedly resolves failing CI and review comments until the work is fully converged or escalated.
  • Use Case: A developer finishes a feature and asks this Skill to verify, ship, and stabilize it all the way to a clean PR state.

Quick Start

Ask the shipping skill to take an already green change through verification, PR creation, CI recovery, and review response until it is merge-ready.

Frequently Asked Questions about shipping

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

FAQPage Schema
How do I create a merge-ready pull request after my code passes verification?

This Skill coordinates the full handoff from green implementation to a merge-ready pull request by running quality gates, checking done criteria, and materializing the PR in GitHub, ensuring the branch is fully prepared for review.

How does CI recovery work when a GitHub pull request fails checks?

CI recovery works by repeatedly resolving failing CI checks and review comments until the work fully converges. If CI or review convergence stalls, the Skill explicitly escalates the issue to prevent infinite loops and stabilize the PR.

What is the process for automating code review and PR creation in GitHub workflows?

The process applies ordered phase gating to automate code review and PR creation in GitHub workflows. It dispatches fresh subagents, runs simplification and review phases, and verifies done criteria before proceeding to PR materialization.

Does this Skill require any specific dependencies or tools to run shipping workflows?

No specific dependencies are required to run shipping workflows. The Skill relies on standard git and gh inspection tools to verify changes, create pull requests, and resolve CI failures within your existing GitHub environment.

When should I escalate a pull request that is not converging during code review?

You should escalate a pull request when CI or review convergence stalls and repeated resolution attempts fail. The Skill detects this lack of convergence during the review-response loop and triggers explicit escalation to prevent manual orchestration deadlock.