# Phase Commit

> Create one local commit for a completed, validated, and reviewed unit of work. Use only when the user explicitly requests a commit without pushing or other delivery actions.

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

---


# Phase Commit

Create one isolated local commit without changing history or external state.

## Workflow

1. Confirm required repository checks and applicable validation and review cover the exact intended content.
2. Inspect status, staged and unstaged changes, and relevant untracked files; preserve all unrelated user work.
3. Stop when scope is ambiguous or includes sensitive, unexpectedly generated, or otherwise unsafe paths.
4. Stage only explicit paths with `git add -- <paths>`; never use broad staging commands or globs.
5. Review the staged path list and diff against the requested unit.
6. Draft the commit subject and body using repository conventions, then use `text-improve` without changing technical meaning.
7. Commit without bypassing hooks or changing signing policy.
8. Verify the created commit content and remaining worktree.

Do not amend, rewrite history, push, create branches or pull requests, manage CI, tag, release, or include unrelated changes.

On hook or commit failure, stop and report the blocker without claiming completion.

Finish only after verifying the created commit, then report its hash and concise summary.