git-commit_skill

Overview

This skill provides a smart, safe git commit workflow that stages changes, crafts conventional commit messages, and performs optional pushes. It inspects the working tree, prevents committing secrets or dangerous operations, and adds co-author attribution automatically. The workflow is designed to be predictable and auditable for local development or CI-assisted commits.

How this skill works

It analyzes the repository state (unstaged, staged, untracked files) and shows a concise diff summary before any actions. It performs smart staging while excluding common secret patterns, generates Conventional Commits-style messages with optional body and Co-Authored-By attribution, and runs safety checks to avoid risky commands. If requested, it pushes to origin and produces a visual push summary.

When to use it

• Commit local changes with a clear, conventional commit message
• Commit a selected subset of files instead of everything
• Commit + push in one step when ready to publish to origin
• When you want automatic co-author attribution added
• When you need safety checks to prevent committing secrets or forcing pushed history

Best practices

• Review the diff summary before staging or committing
• Never force-push without explicit confirmation
• Exclude common secret patterns (.env, *.key, credentials.json) from staging
• Use Conventional Commits format: type(scope): short description, with optional body
• Respect pre-commit hooks; fix issues rather than bypassing with --no-verify

Example use cases

• User says “commit”: show status, stage safe files, craft a conventional commit, and commit locally
• User says “commit these files”: stage listed files (excluding secrets) and commit with a tailored message
• User says “commit and push”: perform commit then push to origin and return a visual push summary
• Handle pre-commit failures by reporting hook output and guiding fixes rather than forcing a commit
• Amend last commit only when explicitly requested and safe (not pushed and created this session)