skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
helderberto/agent-skills52 installs

ship

Commit and push changes with a pre-launch gate (validate-code + safe-repo) by default. `--fast` skips the gate.

How do I install this agent skill?

npx skills add https://github.com/helderberto/agent-skills --skill ship
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides a secure workflow for committing and pushing code, incorporating automated gates for code validation and sensitive data scanning. It uses standard git commands to manage version control tasks safely.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Ship Changes

Ship runs a pre-launch gate before committing. By default: validate-code + safe-repo. The gate ensures nothing broken or unsafe leaves the working tree.

Arguments

  • --fast — skip the pre-launch gate. Only for hotfixes, disposable branches (spike/prototype/CI), or when the gate already passed manually this session. Never on main/release. State the reason in the commit body.

Workflow

Phase 1 — Pre-launch gate (skipped if --fast)

  1. Validate code: invoke the validate-code skill. Auto-fixes formatting, verifies types, runs tests.
    • If validate-code returns FAIL → report errors, STOP. Do not commit or push.
  2. Sensitive data scan: invoke the safe-repo skill against the staged + unstaged diff only (not the whole repo).
    • If sensitive data found → report findings, STOP. Do not commit or push.

Phase 2 — Commit

  1. Review all changes from status and diff
  2. Analyze recent commit style from log
  3. Group changed files by logical concern using commit grouping rules
  4. For each group: stage specific files by name, commit with HEREDOC format
  5. If all changes form one logical unit, stage files by name (never git add -A or git add .)

Phase 3 — Push

  1. Push: git push (current branch)
  2. Run git status after to verify

Rules

  • Pre-launch gate runs by default; only skip via --fast with a stated reason; never --fast on main/release branches
  • Group changes into atomic commits when they serve distinct purposes
  • NEVER force push (-f or --force)

Error Handling

  • 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)
  • If --fast is used → log "Pre-launch gate skipped via --fast" in agent output for traceability

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/helderberto/agent-skills/ship">View ship on skillZs</a>