Skip to main content
skill CX Codex

w-ship — Claude Code skill: what it does and how to install

The w-ship Claude Code skill takes a requested change from implementation through pull request. It reads repository guidance, validates the work, commits it, and creates or updates a PR.

MIT 647 installs ★ 1 updated 2026-10-02

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add blockmatic-icebox/basilic-skills --skill w-ship -a claude-code
Open on GitHub

What w-ship does

w-ship implements a requested change, checks it, and publishes it through a pull request. It reads the task or plan, repository instructions, branch state, affected docs, and scripts. The workflow follows the repository's Git publishing rules and covers the full path to a PR, rather than stopping at a commit or moving on to a merge or deployment.

Changes are made in complete slices. When behavior or commands change, the skill updates the matching MDX and nearest README. It runs the repository's full pre-push gate: pnpm qa in Basilic, or the documented equivalent in another repository. A dirty working tree stops the workflow; it does not stash changes. After validation, w-ship commits task-owned changes, pushes to the inspected upstream, and creates or updates the PR. If a gate fails, it reports the blocker and local work completed instead of presenting an unpublished change as shipped.

What it helps with

  • carry a requested change through to a pull request
  • run the repository's pre-push checks before publishing
  • update docs when behavior or commands change
  • create or update a PR after pushing a branch

Example prompts for the agent

  • Implement this change, run the checks, and open a pull request.
  • Take this plan through to a PR and report the check results.
  • Make the requested change and update the related README if commands change.

How to install w-ship

1Skills CLI (Vercel)

npx skills add blockmatic-icebox/basilic-skills --skill w-ship -a claude-code

2Manually: put the files in place

~/.claude/skills/w-ship/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/w-ship/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about w-ship

How do I install w-ship in Claude Code?

Run npx skills add blockmatic-icebox/basilic-skills --skill w-ship -a claude-code. The skill file is at ~/.claude/skills/w-ship/SKILL.md.

What does w-ship do?

It implements a change, runs the full pre-push gate, commits and pushes the work, then creates or updates a PR. It reports the commit, branch, PR link, and checks.

What happens if the working tree is dirty?

The workflow stops and does not stash the changes. If a validation gate fails, w-ship reports the blocker and the local work completed.

Source text

SKILL.md · MIT
---
name: w-ship
description: Implement the requested change, validate, commit, push, and create its PR.
disable-model-invocation: true
---

Invocation requests the complete implementation-to-PR path, not a lone commit (`/w-commit`) and not merge or deploy. Read the task or plan, repository instructions, branch state, affected docs, and scripts. Follow [git publish](references/git-publish.md). Do not open a child SKILL.md unless that Git step is blocked.

1. Follow git-publish branch rules. Dirty tree stops (no stash). Every new branch: `git fetch origin` then `git switch -c <name> --no-track origin/main` — never skip fetch, never a stale local `main`.
2. Implement in complete slices. Docs as `/w-build`: matching MDX and nearest README when behavior/commands/conventions changed, or one line why not.
3. Run the repository's full pre-push gate (`pnpm qa` in Basilic, or the consuming repo's documented equivalent). This is the only playbook that requires that gate. Diagnose failures before publishing.
4. Commit task-owned changes, then push the inspected upstream.
5. Create or update the PR. Return commit, branch, PR link, and checks. If a gate fails, report the blocker and completed local work; do not present an unpublished change as shipped.

© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills

Similar skills

All skills for Git and GitHub →

From the same set45

The whole set →
w-vercel The w-vercel Claude Code skill examines Vercel build failures and fixes the local build. It handles failures on the current branch. CX Codex +1 647installs w-gha w-gha — a Claude Code skill that retrieves GitHub Actions logs with gh, analyzes failures, and helps fix CI errors locally. Invoke it to investigate a failed workflow on the current branch. CX Codex +1 647installs w-debug-browser The w-debug-browser Claude Code skill reproduces and fixes authorized browser issues using runtime evidence. It inspects DOM, network, and console data, then replays the interaction after a fix. CX Codex +1 647installs w-debug The w-debug Claude Code skill traces failures through logs and reproduction steps. After an authorized fix, it reruns the original scenario and affected checks. CX Codex +1 647installs w-fix-push The w-fix-push Claude Code skill addresses reported issues, runs a matching check, then commits and pushes the changes. It starts from a request to fix specific problems. CX Codex +1 647installs w-git-repair The w-git-repair Claude Code skill diagnoses local Git problems and conflicts. It checks repository state before suggesting repair commands. CX Codex +1 647installs w-comments The w-comments Claude Code skill handles reviewer comments on pull requests and applies requested fixes. It drafts a reply for each comment and only commits after /w-commit is invoked. CX Codex +1 647installs w-pr The w-pr Claude Code skill creates or updates a pull request for the intended branch. It publishes the branch, writes the PR description, and checks the result. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open