feat: add commit skill

2026-07-10 09:16:06 -04:00
parent e16ca1114a
commit 36536e0e11
2 changed files with 31 additions and 0 deletions
@@ -6,6 +6,7 @@ A collection of agent skills (slash commands and behaviors) loaded into Steve Be

 - [agent-handoff](common/in-progress/agent-handoff/SKILL.md) — Hand the current conversation off to a fresh background agent that picks up the work immediately.
 - [audio-product-dsp](common/deprecated/audio-production-dispatcher/SKILL.md) — Dispatch audio product DSP hardware/software engineering requests to the best specialist workflow with measurable product-focused outputs.
+- [commit](common/engineering/commit/SKILL.md) — Commit staged files with a conventional commit message.
 - [conversation-summary](common/pkm/conversation-summary/SKILL.md) — Save the current conversation as a comprehensive report note in your Obsidian vault, following OKF v0.1 conventions.
 - [crit](common/pkm/crit/SKILL.md) — Brainstorm with AI using the CRIT framework to generate and evaluate ideas.
 - [dsp-research-engineering](common/deprecated/dsp-research-dispatcher/SKILL.md) — Route DSP hardware and software research-engineering requests to the best specialist workflow and return a unified, decision-ready output.
@@ -0,0 +1,30 @@
+---
+name: commit
+description: Commit staged files with a conventional commit message.
+disable-model-invocation: true
+---
+
+Commit staged files with a conventional commit message.
+
+## Process
+
+1. **Check the staging area** — Run `git diff --cached --stat`. If empty, report "nothing staged" and stop.
+
+   Completion criterion: Staged files are listed, or the skill terminates.
+
+2. **Draft the message** — Inspect `git diff --cached` to understand what changed. Write a [conventional commit](https://www.conventionalcommits.org/) message:
+
+   - Format: `type(scope): summary` — scope is optional.
+   - Common types: `feat`, `fix`, `refactor`, `docs`, `chore`, `test`, `style`, `perf`, `ci`, `build`.
+   - Summary: imperative mood, lowercase, no period, ≤72 characters.
+   - Body (if needed): wrap at 72 characters, explain _what_ and _why_, not _how_.
+
+   Completion criterion: A conventional commit message is composed.
+
+3. **Commit** — Run `git commit -m "<message>"`. If the commit fails, report the error and stop.
+
+   Completion criterion: `git commit` exits 0.
+
+4. **Report** — Print the short commit hash and the first line of the message.
+
+   Completion criterion: The hash and message are printed.