ship

Installation
SKILL.md
Contains Shell Commands

This skill contains shell command directives (!`command`) that may execute system commands. Review carefully before installing.

Ship Changes

Pre-loaded context

  • Status: !git status
  • Diff: !git diff HEAD
  • Log: !git log --oneline -10

Workflow

  1. Review all changes from status and diff
  2. Analyze recent commit style from log
  3. Check for quality check commands:
    • If package.json exists, check for lint and test scripts
    • Run available checks in parallel: npm run lint, npm test
    • If no package.json, skip quality checks
  4. If checks fail: report errors, STOP — do not commit or push
  5. Group changed files by logical concern using atomic-commits grouping rules
  6. For each group: stage specific files by name, commit with HEREDOC format
  7. If all changes form one logical unit, stage files by name (never git add -A or git add .)
  8. Push: git push (current branch)
  9. Run git status after to verify

Rules

  • Stage files by name, never git add -A or git add .
  • Group changes into atomic commits when they serve distinct purposes
  • Generate message from changed files, match repo style
  • Only run package manager commands if package.json exists with those scripts
  • NEVER push if lint or tests fail
  • NEVER force push (-f or --force)
  • NEVER skip hooks
  • NEVER commit secrets
  • Push to current branch only

Error Handling

  • If lint or tests fail → report all errors, stop; do not commit or push
  • If git push is rejected (non-fast-forward) → run git pull --rebase then retry push once
  • If pre-commit hook fails → fix reported issues, re-stage, create a NEW commit (never --amend)
Related skills

More from helderberto/skills

Installs
45
GitHub Stars
8
First Seen
Feb 13, 2026