git-commit

SKILL.md preview

---
name: git-commit
description: >-
  Local savepoint: read-only inventory first; if nothing to commit, no-op without Q&A. Otherwise one Proceed for
  stage (default full tree) + commit message + mutating add/commit. No git-review, no docs pass, no push.
---

# `@git-commit` (local savepoint commit, no push)

Normative fences / full matrix: [`write-commit`](../../internal/write/commit/SKILL.md).

**Public.** **Goal:** record a local commit with **one** explicit **Cancel / Proceed** before mutating, without invoking **`@git-review`**, **`@git-docs`**, or **`@git-push`**.

**Route here when:** the user wants a **savepoint** on the current branch. **Not for:** verify (**`@git-review`**), publish (**`@git-push`**), or temporary park (**`@git-stash`**).

## Language interaction policy

Always apply [`read-safety-language-interaction-rules`](../../internal/read/safety/language-interaction-rules/SKILL.md) first. Use English by default for all assistant output, including AskQuestion prompts/options, unless the user explicitly requests another full-language response.

## Before batch

**Always run first** (sequential). Complete every applicable row in this table before execution steps in this skill. Skip a row only when its **When** column does not apply.

| Kind | Skill / library | When |
| --- | --- | --- |
| **Recommended** | [`@git-review`](../review/SKILL.md) | User wants verify context before saving |
| **Recommended** | [`@git-start`](../start/SKILL.md) | On **`main`** with **`origin`**, prefer a feature branch before savepoint |
| **Recommended** | [`@git-large-files`](../large/files/SKILL.md) | User wants a full top-N bloat audit before fixing **`.gitignore`** / assets |
| **Tooling** | `git` | Repo root |




## Required internal skills

Run after **Before batch** completes (names only; normative fences in linked libraries).

| Library | Role |
| --- | --- |
| `write-commit` | See linked library |
| `read-workflow-commit-preflight` | Pre-commit validators (unless skipped) |
| `read-safety-structured-qa` | See linked library |
| `read-safety-skill-safety` | See linked library |

## Skip & suggestions

| Flag / param | Role |
| --- | --- |
| **`skip=false`** | Root invocation — offer next-step suggestions after **Verification** |
| **`skip=true`** | Nested public-skill child call — no next-step prompt |
| **`SKIP_COMMIT_PREFLIGHT=true`** | Skip large-file / **`.gitignore`** preflight (staging gate may still run) |
| **`SKIP_QA_GIT_COMMIT=true`** | Bypass routine write gates for this skill |
| **`SKIP_QA_WRITE=true`** | Shared write-flow Q&A bypass where allowed |
| **`SKIP_SUGGESTIONS=true`** | Suppress next-step suggestions even at root |

High-risk or destructive confirmations still require explicit user confirmation when bypass flags are set.

## On invoke

1. **Preconditions** — Run **Preconditions (read-only)** in **`write-commit`**.
2. **Inventory** — Run **Inspect working tree (read-only)** and summarize staged/unstaged/untracked state.
3. **Nothing to commit** — If the working tree is **clean**, **stop** with a one-line no-op. **No write gate**.
4. **Preflight** (when step 3 does not apply and **`SKIP_COMMIT_PREFLIGHT`** is unset) — Run **`read-workflow-commit-preflight`**. On **strong advisory** findings, **`read-safety-structured-qa` §0** with kind **commit-preflight** (**Fix first** / **Proceed anyway** / **Abort**). **Abort** or **Fix first** stops before staging. **Proceed anyway** → step 5.
5. **Write gate** — **`read-safety-structured-qa` §0** with kind **staging** (branch context, staging scope, **`COMMIT_SUBJECT`** in chat summary). **Proceed** → matching **`write-commit`** blocks.
6. **Mutations** — Run the agreed staging block from **`write-commit`**, then **Create commit (mutating)**.

**Narrow scope follow-up:** If paths are ambiguous, **one** chat clarification per **`read-safety-structured-qa` §4** — not a second write gate unless scope changed.

## Do

- Use this skill for local savepoints before destru

…