# Commit Helper

> Impact-focused git commit messages. Use when the user wants to commit changes with a well-crafted message. Use when this capability is needed.

- Skill: `tomevault-io/commit-helper-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/commit-helper-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/commit-helper-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/commit-helper-2

---


Prepare a git commit following these steps:

1. Run `git status` and `git diff` to see changes
2. Review recent commits (`git log --oneline -5`) to match the style
3. Draft a concise commit message:
  - Start with type prefix: `feat:`, `fix:`, `refactor:`, `docs:`, `test:`, `chore:`
  - **Focus on IMPACT and WHY, not implementation details**
  - The title should describe the user-visible outcome or bug fixed
  - Use bullet points (dash prefix) only if there are multiple distinct changes
  - Keep each line under 72 characters
  - No emojis
4. Run the `developer_git_commit_proposal` tool to propose the commit to the user
  - Do NOT run `git add` - the widget handles staging when the user confirms

**Commit Message Guidelines:**
- Lead with the problem solved or capability added, not the technique used
- BAD: "feat: add pre-edit tagging for non-agentic AI providers"
- GOOD: "fix: OpenAI/LMStudio diffs now persist across app restarts"
- BAD: "refactor: extract helper function for validation"
- GOOD: "fix: prevent crash when user input is empty"
- The body can explain HOW if it's non-obvious, but title = IMPACT

**Issue Linking (for auto-close):**
- If fixing a Linear issue, include `Fixes NIM-XXX` on its own line after the title
- For GitHub issues, use `Fixes #XXX` or `Closes #XXX`

**Important:**
- Do NOT add "Co-Authored-By" or any attribution lines
- Do NOT add marketing taglines or links
- Be direct and factual
- Keep it brief - avoid unnecessary details about what wasn't changed

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nimbalyst) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

