skills.rest
mycelium-io
mycelium-ioOFFICIAL
Explore all skills by this author →
WebsiteGitHub

ship

Automate precommit checks, staging, conventional commits, and optional pushes.

112|10|Updated Mar 16, 2026
Search Tags:#git#workflow#commit#push#precommit#pull-request#conventional-commits
One-click install
npx skills add https://github.com/mycelium-io/mycelium --skill ship-mycelium-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/mycelium-io/mycelium/tree/main/.claude/skills/ship
Command: npx skills add https://github.com/mycelium-io/mycelium --skill ship-mycelium-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ship changes efficiently by automating precommit checks, staging, committing, and optional pushing, reducing manual overhead.

Core Features & Use Cases

  • Branch checks: Verify current branch and create a feature branch when needed before proceeding.
  • Precommit: Run lint, format, tests; stop if failures occur.
  • Review changes: Show what will be committed.
  • Stage: Prepare files for commit, excluding secrets and credentials.
  • Commit: Use conventional commit messaging (feat:, fix:, etc.).
  • Push + PR: Push to main and create a PR using gh pr create; never force push.
  • Watch checks: Monitor PR checks and report results.

Quick Start

Say "ship" to run precommit, commit your changes, and optionally push.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I automate git precommit checks and conventional commits?▼

You can automate your git workflow by running precommit checks for linting and tests, staging changes, and creating a conventional commit automatically. This stops the process if checks fail, ensuring commit hygiene.

Can I automatically push changes and create a pull request with conventional commits?▼

Yes, you can automatically push committed changes to the remote repository and create a pull request using gh pr create. It monitors PR checks and reports results without force pushing.

Do I need a valid git repository to run precommit and push workflows?▼

Yes, you need a valid local git repository context and access to the remote origin to push. The workflow verifies the current branch and can create a feature branch before proceeding.

What happens if lint or test checks fail during the git commit workflow?▼

If precommit checks like lint, format, or tests fail, the workflow stops immediately. This prevents broken code from being staged, committed, or pushed to the remote repository.

How do I exclude secrets when staging files for a git commit?▼

When staging changes for a commit, the workflow prepares files while automatically excluding secrets and credentials. It reviews what will be committed before staging to prevent sensitive data leaks.

What is the best way to enforce conventional commit messages in a git workflow?▼

Automating the workflow ensures conventional commit messaging using prefixes like feat: and fix:. It stages your changes and formats the commit automatically to maintain consistent commit hygiene.

Related Skills

Explore More Software Engineering Skills→
Tx1207Tx1207
5

project-creator

Create a new project from a template, initialize uv, and configure a local Git repository.

Community
Advanced
JacobPEvansJacobPEvans
3

rebase-pr

Rebase pull requests onto main with signed commits and GitHub API checks.

Community
Advanced
smarmen86smarmen86

health

Calculate a weighted composite code quality score from linters, type checkers, and test suites.

Community
Intermediate
paulnsorensenpaulnsorensen
2

commit

Stage specific files and create conventional commits in Git.

Community
Intermediate