Ship

Skill that gives AI coding agents persistent memory and quality enforcementFrom the repository description

Install

npx -y skills add mattjaikaran/meridian --skill ship

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.8 KB, 478 tokens by cl100k_base, as published. Nobody here has run it

/meridian:ship — Commit + Push + PR

Ship completed work: commit staged changes, push to remote, create PR.

Arguments

--commit-only — Just commit, don't push or create PR
--push-only — Push existing commits, create PR
--no-pr — Push without creating PR
--branch <name> — Override branch name

Procedure

Step 1: Check Git State

git status
git diff --stat
git log --oneline -5

Step 2: Verify Tests Pass

Run the project's test suite before shipping:

# Detect and run appropriate test command
uv run pytest tests/  # Python
# or: bun test         # TypeScript
# or: cargo test       # Rust

If tests fail, do NOT ship. Show failures and suggest /meridian:debug.

Step 3: Commit

Stage relevant files and commit with Meridian prefix:

git add <files>
git commit -m "[meridian] <descriptive message>"

Step 4: Push

git push -u origin <branch>

Step 5: Create PR

gh pr create --title "<title>" --body "$(cat <<'EOF'
## Summary
<bullet points from completed plans>

## Changes
<files changed summary>

## Testing
<test results>

## Meridian Context
- Milestone: <milestone>
- Phase: <phase>
- Plans completed: <count>

---
Generated by Meridian
EOF
)"

Step 6: Record in State

Update plan commit SHAs and create checkpoint:

PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c "
from scripts.db import connect, get_db_path
from scripts.state import create_checkpoint
conn = connect(get_db_path('.'))
create_checkpoint(conn, trigger='phase_complete', notes='Shipped to PR')
conn.close()
"

Step 7: Export State

PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c "
from scripts.export import export_state
export_state('.')
"

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Gives 0 of the 12 instructions most ship operate skills give in 478 tokens

Counted across 779 of the 1,178 authors here whose files we hold, read 2026-08-07

Document a rollback plan before deploymentin 41 of 779, across 22 files
Update the changelogin 21 of 779, across 19 files
Run the test suitein 20 of 779
Create an annotated git tagin 20 of 779
Clean up feature flags after full rolloutin 18 of 779, across 10 files
Verify deployment health after launchin 18 of 779, across 10 files
Test both feature flag statesin 17 of 779, across 9 files
Verify the working tree is cleanin 17 of 779
Make database migrations backward-compatiblein 16 of 779, across 8 files
Set up error monitoring before launchin 15 of 779, across 7 files
Monitor metrics at each rollout stagein 14 of 779, across 5 files
Create a GitHub releasein 14 of 779

Said here and by no other author read

commit with prefix
update plan commit SHAs and create checkpoint
export state

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.