speckit-git-commit

Stage and commit Spec Kit changes after lifecycle hooks via git-config.yml.

60|12|Updated Aug 1, 2013
One-click install
npx skills add https://github.com/vtex/front.phone --skill speckit-git-commit-vtex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-commit
Source: https://github.com/vtex/front.phone/tree/main/.agents/skills/speckit-git-commit
Command: npx skills add https://github.com/vtex/front.phone --skill speckit-git-commit-vtex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speckit-git-commit removes the repetitive step of manually staging and committing Spec Kit changes by automatically committing updates after specified Spec Kit lifecycle hooks.

Core Features & Use Cases

  • Hook-Based Auto-Commit: Automatically stages and commits changes after (or before) key Spec Kit commands by detecting the triggering hook event.
  • Configurable Per-Event Behavior: Enables auto-commit via .specify/extensions/git/git-config.yml with support for auto_commit.default plus event-specific overrides and custom commit messages.
  • Safe Skips and Guardrails: Gracefully skips when Git is unavailable, when the directory is not a repository, when configuration is missing (disabled by default), or when there are no changes to commit.

Quick Start

Add the auto_commit configuration in .specify/extensions/git/git-config.yml and ensure the Spec Kit hook invokes this skill so it runs git add and git commit for the configured events.

Frequently Asked Questions about speckit-git-commit

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

FAQPage Schema
How do I auto-commit Spec Kit changes after lifecycle hooks?

Auto-committing Spec Kit changes requires configuring `.specify/extensions/git/git-config.yml` with the `auto_commit` setting and ensuring the hook invokes the skill to run `git add` and `git commit` for the configured events.

How does Spec Kit Git auto-commit handle missing configuration or Git repositories?

Spec Kit Git auto-commit safely skips execution when Git is unavailable, the directory is not a repository, configuration is missing, or there are no file changes to commit, preventing errors in unsupported environments.

Can I configure custom commit messages for specific Spec Kit lifecycle events?

Yes, you can configure custom commit messages for specific Spec Kit events by using `auto_commit.default` and event-specific overrides within the `.specify/extensions/git/git-config.yml` file to determine the resolved commit message.

Does Spec Kit Git auto-commit support both Bash and PowerShell scripts?

Yes, Spec Kit Git auto-commit supports both environments by invoking the correct Bash or PowerShell auto-commit script with the resolved event name to stage and commit changes across different operating systems.

What is the default fallback behavior for Spec Kit Git commit events?

The default fallback behavior for Spec Kit Git commit events is disabled by default unless explicitly enabled, deciding per-event enablement based on the `auto_commit.default` setting and event-specific overrides in the configuration.