commit

Reviews staged changes and creates a conventional git commit.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/KMakayee/playbook --skill commit-kmakayee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit
Source: https://github.com/KMakayee/playbook/tree/main/.claude/skills/commit
Command: npx skills add https://github.com/KMakayee/playbook --skill commit-kmakayee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents sloppy or incomplete git commits by forcing a quick staged-review loop, handling untracked files intentionally, and guiding you to write a clean conventional commit message before creating and pushing the commit.

Core Features & Use Cases

  • Staged-change review: Shows git status and both unstaged (git diff) and staged (git diff --staged) context so you commit with confidence.
  • Untracked file handling: Detects untracked files and prompts you to decide which ones to include.
  • Conventional commit drafting: Produces a concise type: subject message (subject under 72 characters) derived from the staged diff.
  • Automated commit and push: Commits to the current branch and pushes it, then logs noteworthy learnings to tasks/errors.md via the repo reflection template.

Quick Start

Run the commit skill to review your staged changes, draft a conventional commit message, create the commit, and push it to your current branch.

Frequently Asked Questions about commit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a conventional commit message from staged git changes?

A conventional commit message is generated by reviewing your staged diff and extracting a concise type: subject format, keeping the subject under 72 characters. The skill drafts this automatically before committing to your current branch.

How do I make sure untracked files are handled before pushing a git commit?

Untracked files are handled intentionally by detecting them via git status and prompting you to decide which ones to include. This prevents accidentally leaving necessary files out of your git commit before pushing.

What is the best way to review staged and unstaged changes before a git push?

The best way to review changes before a git push is to check both git diff for unstaged edits and git diff --staged for staged edits. This ensures you commit exactly what you intend to the current branch.

Can I automate git commit and push to my current branch in one step?

Yes, you can automate git commit and push by running the skill after staging files. It reviews the changes, creates the commit with a conventional message, and pushes the result directly to your current branch.

How does a conventional commit workflow handle git errors and reflection logs?

A conventional commit workflow handles git errors and reflection logs by recording noteworthy learnings into tasks/errors.md after pushing. This ensures development errors are tracked for future reference.

Do I need to manually stage files before running an automated git commit?

Yes, you need to manually stage files using git add before running the automated commit. The skill checks git status to show staged and unstaged context but expects you to stage changes intentionally first.