ship · plugin87 — Claude Code skill: release checks and installation
ship — a skill for Claude Code runs pre-release checks and drafts a release checklist. It starts before a release tag, checking the project before preparing version and changelog details.
MIT ★ 3,216 updated 2026-11-10
/plugin marketplace add plugin87/ux-ui-agent-skills
/plugin install ux-ui-agent-skills@ux-ui-agent-skillsWhat ship does
ship checks a UX/UI project before release and drafts the release notes. It runs an accuracy report, checks responsive examples, and scans interface and instruction text for emoji. A failed check stops the checklist stage.
The skill requires the full UX/UI Agent Skills kit: gates, references, and the design-system library. Installing only the skill folder with npx [email protected] add does not include that kit. Its scripts need node and python3.
Next, ship updates the version badge, current line, and changelog entry in README.md. It lists commits since the previous tag and asks the user to confirm the version bump. The skill drafts only; git tag and publishing wait for explicit approval.
What it helps with
- run release checks on a UX/UI project
- catch responsive issues in examples
- draft a version badge and changelog entry
- list commits since the previous tag
Example prompts for the agent
- Run the full pre-release gate and draft the release checklist.
- Check the examples for responsive issues and prepare a changelog draft.
- Prepare the release, but do not create a tag or publish it.
How to install ship
1Plugin marketplace
/plugin marketplace add plugin87/ux-ui-agent-skills/plugin install ux-ui-agent-skills@ux-ui-agent-skillsThis installs the whole ux-ui-agent-skills plugin with all its skills
2Skills CLI (Vercel)
npx skills add plugin87/ux-ui-agent-skills --skill ship -a claude-code3Manually: put the files in place
~/.claude/skills/ship/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ship/
1Skills CLI (Vercel)
npx skills add plugin87/ux-ui-agent-skills --skill ship -a codex2Manually: put the files in place
.agents/skills/ship/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add plugin87/ux-ui-agent-skills --skill ship -a cursor2Manually: put the files in place
.cursor/skills/ship/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install plugin87/ux-ui-agent-skills .claude/skills/ship2Manually: put the files in place
.github/skills/ship/SKILL.md1Skills CLI (Vercel)
npx skills add plugin87/ux-ui-agent-skills --skill ship -a gemini-cli2Platform CLI
gemini skills install https://github.com/plugin87/ux-ui-agent-skills --path .claude/skills/shipManually: put the files in place
.devin/skills/ship/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ship
How do I install ship in Claude Code?
Add the marketplace with /plugin marketplace add plugin87/ux-ui-agent-skills, then install the plugin with /plugin install ux-ui-agent-skills@ux-ui-agent-skills. The full UX/UI Agent Skills kit is required.
What does ship do?
It runs pre-release quality checks, then prepares a checklist and changelog draft. Creating a tag or publishing requires separate approval.
What does ship need to run?
It needs the full UX/UI Agent Skills kit, including gates, references, and the design-system library. The checks also require node and python3.
Source text
SKILL.md · MIT
--- name: ship description: Pre-release gate. Run the full gate, responsive + render checks, then produce the release checklist (README badge/current/changelog). Use before tagging a release. # A command the user runs. Converted from .claude/commands/ so it has a # CLAUDE_SKILL_DIR of its own and its paths resolve on every install route. # disable-model-invocation keeps the behaviour a command had: the user # starts it, the model never does, and its description stays out of the # listing budget the model's skill choice is drawn from. disable-model-invocation: true --- ## Requirements This skill needs the full UX/UI Agent Skills kit: the gates, the references and the design-system library. Install it with `npx [email protected] init` or as the Claude Code plugin. `npx [email protected] add` copies the skill folder and nothing else, and this skill has no guidance-only mode: its whole job is to run the release bar, which is the gates, so without the kit there is nothing for it to do. > **Step 0: is the kit here?** Check once: > `ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING` > On `KIT_MISSING`, say plainly that only the skill folder was installed, name > the install command above, and stop. Do not guess the contents of a file you > could not open, and do not report a result you did not produce. Gate first, then prepare the release. Do nothing destructive without explicit confirmation (no tag, no publish). This command verifies and drafts only. 1. Quality gate (must be fully green before continuing): - `node ${CLAUDE_SKILL_DIR}/../../../scripts/accuracy_report.mjs`: report the real N/N. - `node ${CLAUDE_SKILL_DIR}/../../../scripts/verify_responsive.mjs examples`: no overflow from 280 to 951px, hinge clear when folded. - `python3 ${CLAUDE_SKILL_DIR}/../../../scripts/check_no_emoji.py`: UI + taste + instruction surface. If anything fails, stop and fix; do not proceed to the checklist. 2. Release checklist (per the project release rule): - Update `README.md`: version badge, "current" line, and changelog entry. - Confirm the bump level (major/minor/patch) with the user. It is their call. - Confirm `examples/apple-home` stays gitignored (local IP). - List the commits since the last tag so the changelog is accurate. 3. Output a ready-to-review summary: the green N/N line, the proposed version, and the drafted changelog entry. Wait for the user to approve before any `git tag` / publish step.
© Thientan Soparat · MIT · plugin87/ux-ui-agent-skills
Similar skills
All skills for Testing and QA →ship by other authors comes first.