How does the ship skill determine the next version number?

It parses your project's version files (like package.json or csproj) and suggests an increment (major, minor, or patch) by analyzing git history and changes since the last tag.

Is it safe to run? Does it perform force pushes?

The ship skill is built for safety; it never performs force-pushes and provides a multi-select checklist for you to confirm actions before any changes are executed.

Can I use this skill for monorepos with multiple packages?

Yes, the skill supports a .ship.yml configuration with a 'targets' key, allowing you to manage and release specific projects within a single repository independently.

What happens if I don't have a configuration file?

The skill includes an onboarding flow that auto-discovers your project structure and proposes a .ship.yml configuration for you to approve.

Does it require the GitHub CLI (gh)?

While basic git functions work without it, the 'gh' CLI is required for advanced features like watching CI workflows and creating GitHub Releases.

Ship Release Automation

Name: Ship Release Automation
Author: lucaspimentel

bylucaspimentel

0•

Deployment & DevOps

Streamlines the software release process by automating version bumping, changelog updates, tagging, and CI monitoring.

The Ship skill provides a comprehensive automation framework for software releases within Claude Code. It intelligently detects the current repository state, suggests version increments based on git history, and executes a canonical sequence of actions—including updating version files, generating changelogs, committing changes, creating git tags, pushing to remotes, and monitoring GitHub Actions CI workflows. Whether managing a single project or a multi-target monorepo, Ship ensures consistent and error-free deployments by consolidating complex terminal commands into a single, interactive workflow that can be triggered by simple natural language commands.

Key Features

01Intelligent auto-detection of required release actions based on repository state

02Integrated documentation and changelog synchronization for GitHub Releases

030 GitHub stars

04Real-time CI monitoring using GitHub CLI to watch workflow progress

05Support for multi-target monorepo configurations using .ship.yml

06Automated SemVer resolution (major, minor, patch) via git diff analysis

Use Cases

01Cutting a formal GitHub release including tags, changelogs, and automated CI verification

02Publishing a new version of an NPM or NuGet package with consistent versioning across all files

03Automating repetitive post-coding tasks like staging changes, committing, pushing, and watching build status

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lucaspimentel/claude-plugins ship

For use in Claude.ai and ChatGPT