From pds
Saves checkpoints by staging changes, committing with conventional messages, auto-detecting or specifying version bumps (patch/minor/major), pushing with protected branch checks, and creating PRs. Use for quick shipping of clean, tested work.
How this skill is triggered — by the user, by Claude, or both
Slash command
/pds:checkpointThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Quick finalization workflow. Ships work with a version bump in one command. Use when the full `/finish` protocol (rebase, squash, verify) isn't needed — the work is already clean and tested.
Quick finalization workflow. Ships work with a version bump in one command. Use when the full /finish protocol (rebase, squash, verify) isn't needed — the work is already clean and tested.
/checkpoint # Auto-detect bump type + commit + push
/checkpoint patch # Bump patch + commit + push
/checkpoint minor # Bump minor + commit + push
/checkpoint major # Bump major + commit + push
/checkpoint patch "feat: add scoring" # Explicit commit message for work changes
If uncommitted changes exist (staged or unstaged):
git add relevant files (not -A — be deliberate)<type>(<scope>): <subject>If working tree is clean, skip to step 3.
If no bump type was passed, scan git log since the last version tag:
git log $(git describe --tags --abbrev=0 2>/dev/null)..HEAD --oneline 2>/dev/null || git log --oneline
Apply the highest-precedence rule found:
| Commit prefix | Bump type |
|---|---|
BREAKING CHANGE in body, or ! after type (e.g. feat!:) | major |
feat: | minor |
fix:, perf:, refactor:, etc. | patch |
Follow /pds:bump protocol:
chore: bump version to X.Y.ZProtected branch check. Before pushing, check if the target branch is protected:
Protected Branches section listing branch patterns (e.g., main, release/*)Protected Branches section exists in CLAUDE.md, no branches are protected — push freely.git push origin HEAD
Create or update a PR targeting main:
gh pr create --fill # Create if none exists
gh pr view # Show existing PR
git add -A — stage files deliberately to avoid committing secrets or artifacts.| Situation | Skill |
|---|---|
| Quick ship: work done, bump and push | /checkpoint |
| Formal ship: rebase, squash, verify, PR | /finish |
| Version bump only (no push) | /bump |
| Verify before shipping | /verify then /checkpoint |
After shipping, consider running /pds:pause — shipping is a natural break point. It saves session state so you can resume cleanly in the next session.
/pds:bump — version bump details/pds:finish — formal branch completion protocol/pds:verify — completion self-check/pds:pause — save session state before stepping awaynpx claudepluginhub rmzi/portable-dev-system --plugin pdsManages Git checkpoints via tags: create before risky refactors or multi-step work, restore for rollbacks, list, and clean. Uses Bash for safe Git operations.
Creates a mid-session git commit and handoff note to save progress before risky changes, refactors, or task switches. Use instead of /wrap-up when continuing the session.
Lands working-tree changes as logical commits grouped by concern, topped by a release commit (version bump, changelog, regenerated artifacts) and an annotated tag. Stops at local commit/tag; no push.