shipRelease

Sync feature branches, run tests and coverage audits, then open a pull request.

1|2|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/joi-fairshare/agentic-workflow --skill shiprelease
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shipRelease
Source: https://github.com/joi-fairshare/agentic-workflow/tree/main/skills/shipRelease
Command: npx skills add https://github.com/joi-fairshare/agentic-workflow --skill shiprelease

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual release choreography by ensuring branches are synced, tests and coverage are audited, pushes happen reliably, PRs are opened, and documentation can be kept current.

Core Features & Use Cases

  • Preflight discipline: Validates a clean working tree, prevents running the skill on the base branch, and loads contextual session state before touching git history.
  • Automated quality gates: Detects the project’s test runner, runs the appropriate suite, and checks for coverage tooling so you can confidently ship without manual experimentation.
  • Release completion workstream: Pushes the branch, creates or reports an existing PR, optionally triggers /syncDocs, and records a release report with test, coverage, and documentation status for auditability.

Quick Start

Invoke /shipRelease on a feature branch once your changes are ready so it syncs from main, runs the tests and coverage checks, pushes, opens the PR, and updates docs unless you explicitly skip them.

Frequently Asked Questions about shipRelease

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

FAQPage Schema
How do I automate a GitHub release workflow with branch syncing, tests, and pull requests?

Automated GitHub release workflows coordinate syncing feature branches from main, running test suites and coverage audits, pushing, and opening a PR. This removes manual choreography by validating a clean working tree and applying deterministic git flow operations before shipping.

What does a preflight check do before shipping a git release branch?

A preflight check for shipping a git release validates a clean working tree, prevents running the process on the base branch, and loads contextual session state before touching git history. This ensures deterministic coordination between main and feature branches during the release process.

How do I run tests and check code coverage before opening a pull request?

Running tests and checking code coverage before opening a pull request is handled by automated quality gates that detect the project's test runner, execute the appropriate suite, and verify coverage tooling awareness. This ensures you confidently ship releases without manual experimentation.

Can I automatically sync documentation when creating a release pull request?

Automatically syncing documentation when creating a release pull request is supported by optionally triggering a documentation sync process. The release workstream pushes the branch, creates the PR, optionally updates docs, and records a release report with test, coverage, and documentation status for auditability.

Does automated release coordination work without specific test runner or coverage tool dependencies?

Automated release coordination detects the project's existing test runner and checks for coverage tooling dynamically, so no hardcoded test framework dependencies are required. It runs the appropriate suite based on what is found in your environment before pushing the branch and opening the PR.

Why should I not run release automation directly on the main branch?

Running release automation directly on the main branch is blocked by preflight discipline because the workflow is designed for deterministic coordination between main and feature branches. You must invoke the release process on a feature branch to ensure changes are synced, tested, and pushed correctly.