From 36536e0e1105145e0c9312b536e570c5475c57f7 Mon Sep 17 00:00:00 2001 From: Steve Beaulac Date: Fri, 10 Jul 2026 09:16:06 -0400 Subject: [PATCH] feat: add commit skill --- README.md | 1 + common/engineering/commit/SKILL.md | 30 ++++++++++++++++++++++++++++++ 2 files changed, 31 insertions(+) create mode 100644 common/engineering/commit/SKILL.md diff --git a/README.md b/README.md index 422221c..a5eece5 100644 --- a/README.md +++ b/README.md @@ -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. diff --git a/common/engineering/commit/SKILL.md b/common/engineering/commit/SKILL.md new file mode 100644 index 0000000..6c5a71a --- /dev/null +++ b/common/engineering/commit/SKILL.md @@ -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 ""`. 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.