Agent-Skills.md

Agent Skills: SpecSwarm Ship Workflow

Quality-gated merge to parent branch (DESTRUCTIVE). ALWAYS confirms on ship/deploy/merge/release intent.

UncategorizedID: MartyBonacci/specswarm/ss-ship

Repository

MartyBonacci/specswarm
MartyBonacciLicense: MIT
644

Install this agent skill to your local

pnpm dlx add-skill https://github.com/MartyBonacci/specswarm/tree/HEAD/plugins/ss/skills/ss-ship

Skill Files

Browse the full folder contents for ss-ship.

Download Skill

Loading file tree…

plugins/ss/skills/ss-ship/SKILL.md

Skill Metadata

Name
ss-ship
Description
Logs merge operations for audit trail

SpecSwarm Ship Workflow

Provides natural language access to /ss:ship command.

Dynamic Context

Current branch: !git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "Unknown branch"

When to Invoke

Trigger this skill when the user mentions:

  • Shipping, deploying, or releasing features
  • Merging to main/production
  • Completing or finishing features
  • "Ship it" (common casual phrase - ALWAYS confirm)

Examples:

  • "Ship the authentication feature"
  • "Deploy to production"
  • "Merge this to main"
  • "Ship it" ← Ambiguous - might be casual approval
  • "Release version 2.0"

Instructions

ALWAYS Confirm (Regardless of Confidence):

  1. Detect that user mentioned shipping/deploying/merging

  2. Extract context about what to ship (if provided)

  3. ALWAYS ask for confirmation using AskUserQuestion tool with this format:

    Question: "⚠️ SHIP CONFIRMATION - Destructive Operation"

    Description: "This will merge your feature branch to main/parent branch and delete the feature branch. This is a DESTRUCTIVE operation that cannot be easily undone."

    Options:

    • Option 1 (label: "Yes, ship this feature"): "Merge to main branch and delete feature branch (DESTRUCTIVE)"
    • Option 2 (label: "No, cancel"): "Cancel - I'm not ready to ship" (or if this was just casual "ship it" approval)

  4. If user selects Option 1, run: /ss:ship

  5. If user selects Option 2, process normally without SpecSwarm

  6. Note: The /ss:ship command may have its own confirmation as an additional safety layer

What the Ship Command Does

/ss:ship runs complete workflow:

  • Runs quality analysis and validation
  • Checks quality threshold (default 80%)
  • Shows merge plan with confirmation prompt
  • Merges to parent branch
  • Cleans up feature branch

Important: This is DESTRUCTIVE - it merges and deletes branches. The command itself may have built-in confirmation as a second safety layer.

Semantic Understanding

This skill should trigger not just on exact keywords, but semantic equivalents:

Ship equivalents: ship, deploy, release, merge, publish, finalize, complete, deliver Target terms: production, main, master, parent branch, live, release

Example

User: "Ship it"

Claude: [Shows AskUserQuestion]
1. Run /ss:ship - ⚠️ Merge feature to parent branch (DESTRUCTIVE)
2. Process normally - Handle as regular request

User selects Option 2 (it was casual approval, not actual shipping request)