# Auto Commit Suggestion

> Use this skill when the user wants to know whether a git workspace is ready for a commit, asks for a threshold-based change summary, or wants help deciding when to checkpoint work in Codex.

- Skill: `koyonx/auto-commit-suggestion` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add koyonx/auto-commit-suggestion`
- Raw SKILL.md: https://api.skillmd.com/api/skills/koyonx/auto-commit-suggestion/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: koyonx (https://skillmd.com/u/koyonx)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/koyonx/auto-commit-suggestion

---


# Auto Commit Suggestion

## Overview

Use this skill to evaluate commit readiness in the current git repository.
It is a manual Codex skill, not an automatic hook.

## Workflow

1. Run `scripts/check_commit_threshold.sh` from the repo root or pass `--repo`.
2. Review the changed-file count, staged count, and top changed paths.
3. If the threshold is exceeded, suggest a checkpoint commit and explain why.
4. If the user wants to commit, help prepare a message but do not commit unless asked.

## Thresholds

- Default threshold is `5`.
- Override with `--threshold <n>` or `AUTO_COMMIT_THRESHOLD=<n>`.
- Treat many untracked files or many staged files as stronger commit signals.

## Resources

- Script: `scripts/check_commit_threshold.sh`