urmzd/dotfiles / dot_agents/skills/ship
ship
UnverifiedGenerate a conventional commit message from staged or unstaged changes and create an atomic commit, then optionally push and watch CI until it passes or fails. Use when the user says "write a commit", "generate a commit message", "commit this", "git add .", or "ship this". Push and CI-watch are optional and skipped if the user only wants a commit. Do NOT open a pull request (use pr); do NOT diagnose-then-fix a failing pipeline (use fix-and-retry); do NOT do a read-only CI investigation without committing (use diagnose-ci).
Ship
Commit, push, and watch the CI pipeline.
Steps
-
Stage changes: Run
git status --porcelain. If there are unstaged/untracked changes, stage them (prefer specific files overgit add -A; never stage.envor credential files). -
Commit: If a message argument is provided, use it. Otherwise, generate a conventional commit message from the diff (
feat:,fix:,chore:,docs:,refactor:,test:). Use the repo's recentgit log --oneline -10to match style. -
Push (optional): Only if the user wants to push. Run
git push. If no upstream is set, usegit push -u origin HEAD. If the user only asked for a commit, stop here and report the commit. -
Watch CI (optional): After push, run
gh run list --branch $(git branch --show-current) --limit 1 --json databaseId,status,conclusionin a loop (max 5 minutes, poll every 15s). Report the final status. -
On failure: If CI fails, run
gh run view <id> --log-failedand show the relevant error output so the user can decide next steps.
Rules
- Never commit files that look like secrets (.env, credentials.json, *.pem, *.key).
- Never force push.
- If there are no changes to commit, say so and stop.
- If CI isn't set up (no workflows found), just push and report that there's no CI to watch.
Gotchas
- The
gh runis not registered immediately aftergit push. Poll with retry (a few attempts, a couple seconds apart) before concluding "no run found" -- the run may take several seconds to appear. - If
git pushis rejected by branch protection (protected branch, required reviews, required status checks), stop and report the rejection. Do not retry, force push, or attempt to bypass protection.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |