commit-summarylisted
Install: claude install-skill shipshitdev/skills
# Commit Summary
Generate accurate Conventional Commits from real git diffs.
## Contract
Inputs:
- Repository root
- Staged changes, unstaged changes, or approved paths to stage
- Optional commit type, scope, and breaking-change context
Outputs:
- Commit message candidate
- Logical commit grouping when changes are mixed
- Created commit hash after approval, if requested
Creates/Modifies:
- No changes in message-only mode
- May stage files and create commits after approval
External Side Effects:
- None unless another workflow pushes the commit later
Confirmation Required:
- Before staging files
- Before creating a commit
- Before amending or squashing existing commits
Delegates To:
- `gh-pr-publish` when the commit should be pushed and opened as a PR
- `git-safety` when secrets or sensitive files appear in the diff
## Workflow
1. Inspect repository state:
```bash
git status -sb
git log --oneline -5
git diff --stat
git diff --cached --stat
```
2. Determine whether changes are already staged:
- If staged changes exist, generate the message from `git diff --staged`.
- If nothing is staged, inspect unstaged changes and propose logical groups.
- If unrelated changes are mixed, recommend separate commits.
3. Guard against unsafe commits:
- Do not stage secrets, `.env`, credentials, private keys, local databases,
build caches, or large generated artifacts.
- If sensitive files appear, stop and delegate to `git-safety`.
- Do