skills/golem-powers/commit/SKILL.md
Use when ready to commit changes. Runs CodeRabbit review first, then commits if review passes. Supports Ralph mode for atomic commit + criterion marking. Covers commit, ralph commit, atomic commit. NOT for: pushing or creating PRs (use pr-loop).
npx skillsauth add etanhey/golems commitInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Runs CodeRabbit review on staged changes, then commits if approved.
cr review --plain for headless/Claude compatibility)# Stage your changes first
git add <files>
# Standard commit
/commit
# Ralph mode — atomic commit + mark story criterion
/commit --story=US-106 --message="feat: US-106 description"
When invoked, Claude will:
git diff --staged --stat to show what's stagedcr review --plain (headless mode, works from Claude)When --story is provided, this skill does atomic commit + criterion marking:
| Flag | Description |
|------|-------------|
| --story=ID | Story ID (e.g., US-106, BUG-028) — triggers Ralph mode |
| --message=MSG | Commit message (required in Ralph mode) |
| --files=PATHS | Files to stage (default: prd-json/ + modified files) |
| --dry-run | Show what would happen without doing it |
cr CLI installed (CodeRabbit)git addCommitting is ONE step in the full workflow. After commit:
git push -u origin <branch>/pr-loop (the full loop)Do NOT stop at commit. The mission is MERGED, not committed.
tools
The human-eval UX contract for Phoenix views: turn-by-turn scrollable replay (not a scorecard), hide-but-copyable IDs, collapsed thinking, identity chips, tool filters, tiny frozen starter datasets, mark-wrong-in-thread, mobile-first. Use when: building or reviewing ANY Phoenix/eval view, annotation UI, session replay, or human-grading surface. Triggers: phoenix view, eval UI, annotation view, session replay, human eval UX, grading interface. NOT for: Phoenix data pipelines/ingest (capture scripts have their own specs).
tools
macOS systems specialist — AppKit NSPanel architecture, launchd services, socket activation, MCP bridge resilience, syspolicyd, and high-frequency SwiftUI dashboards. Use when building menu-bar apps, LaunchAgents, debugging syspolicyd/Gatekeeper/TCC, resilient UDS/MCP bridges, or SwiftUI dashboards at 10Hz+.
development
Bulk LLM-judging protocol for fleet-dispatched verdict runs (KG cluster, eval harness). Use when: dispatching or running judge workers (J1/J2/RT), planning bulk-apply from verdict JSONL, or triaging evidence_degraded outputs. Triggers: judge fleet, bulk judge, R3 verdicts, kg-judge, RT gate, evidence_degraded. NOT for: single-item code review, Phoenix view UX (use phoenix-human-view), or non-judge eval pipelines.
development
Quiet-down protocol for sprint close: when the fleet wraps, delete ALL polling crons and monitors, send ONE final dashboard + ONE message, then go SILENT. Use when: fleet wraps, all workers done, overnight queue exhausted, sprint close, Etan asleep/away with nothing approved left. Triggers: fleet wrap, wrap the fleet, stand down, going quiet, sprint close. NOT for: mid-sprint monitoring (keep your loops), spawning a successor (use /session-handoff first).