speckit-git-commit

Automate Git staging and commits for Spec Kit hook events.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/alienstro/mediapipe-scroll --skill speckit-git-commit-alienstro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-commit
Source: https://github.com/alienstro/mediapipe-scroll/tree/main/.agents/skills/speckit-git-commit
Command: npx skills add https://github.com/alienstro/mediapipe-scroll --skill speckit-git-commit-alienstro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speckit-driven work can leave modified files uncommitted, forcing you to remember to stage and commit changes after each command run.

Core Features & Use Cases

  • Hook-based auto-commit: Runs after or before Spec Kit commands by detecting the triggering hook event name.
  • Configurable per-event behavior: Enables or disables commits via .specify/extensions/git/git-config.yml, with auto_commit.default as the fallback.
  • Commit message control: Uses the per-command configured message or applies a sensible default if none is provided.
  • Change-aware execution: Only performs git add . and git commit when there are uncommitted changes, otherwise skips with a message.
  • Graceful degradation: Skips with a warning if Git is unavailable or the current directory is not a repository, and skips when the config file is missing (disabled by default).

Quick Start

Run Spec Kit commands normally, and ensure .specify/extensions/git/git-config.yml sets auto_commit.after_specify.enabled: true to enable automatic commits when hooks fire.

Frequently Asked Questions about speckit-git-commit

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

FAQPage Schema
How do I automatically commit Git changes triggered by Spec Kit hooks?

You can automatically commit Git changes by configuring the `.specify/extensions/git/git-config.yml` file to enable `auto_commit` for specific hook events like `after_specify`. The system then stages and commits uncommitted changes automatically when those Spec Kit command hooks fire.

What happens if there are no uncommitted files when the auto-commit hook runs?

If there are no uncommitted changes when the auto-commit hook runs, the system gracefully skips the `git add` and `git commit` execution. It detects the clean working directory and skips the operation with an informational message rather than failing.

Can I configure different auto-commit behaviors for separate Spec Kit events?

Yes, you can configure different auto-commit behaviors by setting event-specific keys within `.specify/extensions/git/git-config.yml`. The system selects the correct event key during the hook trigger and falls back to the `auto_commit.default` setting if a specific event configuration is missing.

Do I need a Git repository to use Spec Kit auto-commit functionality?

Yes, you need an initialized Git repository to use Spec Kit auto-commit functionality. The system gracefully degrades by skipping the commit process with a warning if Git is unavailable or if the current working directory is not recognized as a valid repository.

How are commit messages generated for automated Spec Kit check-ins?

Commit messages for automated Spec Kit check-ins are generated using the per-command configured `message` property defined in the `git-config.yml` file. If no custom message is provided for the specific event, the system applies a sensible default message automatically.

Why does Spec Kit skip the auto-commit process when the config file is missing?

Spec Kit skips the auto-commit process when the configuration file is missing because automatic commits are disabled by default. This graceful degradation prevents unintended Git operations unless you explicitly create the file and set `auto_commit.enabled: true`.