From runway
Ship a backlog item — create a version branch, write the changelog entry, bump the version, build, commit, and push. Use when the user signals readiness to release: "ready to commit", "ship this", "let's push", "time to release", "I'm done with X".
How this skill is triggered — by the user, by Claude, or both
Slash command
/runway:ship-from-backlogWhen to use
ready to commit, ship this, push it, time to release, let's release, done with, commit and push, ship it, release this, I'm done
haikuThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
If what's shipping isn't clear from context, ask in one sentence before proceeding.
If what's shipping isn't clear from context, ask in one sentence before proceeding.
Steps — run in order, do not skip:
If CHANGELOG.md does not exist, invoke bootstrap-changelog first. Read CLAUDE.md for the ## Version tracking section to determine where the version is stored. Then read the current version from the appropriate source:
package.json → "version" fieldVERSION file → file contents## [X.Y.Z] heading (or 0.0.0 if no entries yet)Also read BACKLOG.md to find the item and its type. Stop once you have the item type and current version.
Semver bump: feature → minor (reset patch); bug / improvement / cleanup / known issue / limitation → patch; breaking change → major (reset minor + patch). Confirm with the user if ambiguous.
git switch -c vX.Y.Z main
CHANGELOG.md — insert a new block at the top (below the heading and intro):
## [X.Y.Z] — YYYY-MM-DD
### Added / Changed / Fixed / Removed
- **Name.** User-facing summary of what changed and why. (`src/file.tsx`, …)
Only include subsections with entries. Use today's date.
BACKLOG.md — remove the item's table row (the title cell may be a [Title](#anchor) link — match on the display text) and its detail section. If removing the row leaves the table empty (only the header row remains), replace the entire table with a placeholder line matching the section: "No open feature items." / "No open improvement items." / "No open known issues." / "No open limitations." Keep the section heading. Touch nothing else.
Docs — update only where reality changed: CLAUDE.md (new patterns/gotchas), CONTRIBUTING.md (schema/RLS/env/scripts), README.md (user-visible changes), FAQ/Privacy/Terms/Press (copy claims), robots.txt (new routes). Skip if none apply.
Bump the version in whichever location CLAUDE.md documents:
package.json → set the "version" field onlyVERSION file → overwrite with the new version string onlynpm run build — fix any errors before continuing. Do not commit a broken build.
Stage all changed files. Commit: git commit -m "vX.Y.Z — short description"
git push -u origin vX.Y.Z — stop here. Do not open a PR.
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub squalrus/runway --plugin runway