All commands

Command

/report-bug

structured upstream bug reports

Turn a live Shipmates failure into a structured upstream issue.

See it run

Illustrative terminal recording of the stages /report-bug runs, in order.
Illustrative — the stages /report-bug runs, in order.

How to run it

Run it in your harness

/report-bug [symptom text] [apply] — default report-only preview; apply files on saman-mb/shipmates after captain approval

<angle brackets> = required · [square brackets] = optional

How it works

  1. Capture

    Record what broke, which harness, which command, and the expected vs observed result.

    No specialist — the run harvests context from the session.

  2. Dedupe

    Search existing upstream issues so a duplicate is a comment, not a new ticket.

    Still the run — no spawn until the draft.

  3. Draft

    Shape a title and body a maintainer can act on.

    Also sit when

  4. File

    Preview first; create the GitHub issue only when you say apply.

    No extra spawn — you confirm, then it files.

When to use

  • Shipmates itself misbehaved and maintainers need a triage-ready report.
  • Fixing your own repo? /shipmates-fix-bug. Cleaning a backlog? /consolidate-issues.

The skill

The installer ships the full skill — stages, gates, config — from commands/report-bug.md.

Read the skill on GitHub