committing

Enforce git-spice commands for commits and branch stacking.

13|6|Updated Feb 23, 2013
One-click install
npx skills add https://github.com/abhinav/home --skill committing-abhinav
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: committing
Source: https://github.com/abhinav/home/tree/main/.claude/skills/committing
Command: npx skills add https://github.com/abhinav/home --skill committing-abhinav

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents drift in Git workflows by enforcing the use of git-spice for all commits and branch operations, preserving stack history and automatic rebasing. It also ensures commit messages are generated by the writing-commit-messages skill and avoids raw git usage that leads to broken histories.

Core Features & Use Cases

  • Discipline for commits: All commits are created via gs commands and messages are generated by Skill(writing-commit-messages).
  • Branch stacking: Creating new branches automatically stacks on the current feature branch when applicable.
  • Never use raw Git: Replaces git commit, git checkout -b, and git branch with git-spice commands.

Quick Start

Before committing, load Skill(writing-commit-messages) to craft a proper message, then run: gs branch create <branch-name> -m "<message>" or gs commit create -m "<message>". When amending, use gs commit amend as needed.

Frequently Asked Questions about committing

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

FAQPage Schema
How do I enforce git-spice commits across my team to prevent broken branch stacks?

Enforce git-spice commits by replacing raw git commands with `gs commit create` and `gs branch create` for all commit and branching operations. This Skill prevents stack tracking drift and maintains automatic rebasing of dependent branches, keeping your history intact across collaborative sessions.

What's the difference between using git-spice and raw git commands for committing?

Git-spice (`gs`) preserves stack history and auto-rebases dependent branches, while raw git commands like `git commit` and `git checkout -b` break stack tracking and cause history divergence. This Skill enforces `gs` workflows to maintain consistent branch relationships.

Can I use this Skill with my existing git branching workflow?

Yes. This Skill applies to all commit workflows—creating, amending, and stacking branches—whether single-user or collaborative. It replaces raw git usage with standardized `gs` commands and integrates with the writing-commit-messages Skill for consistent messaging.

How do I recover from using raw git commands after adopting git-spice?

This Skill provides recovery from prior raw git usage by enforcing `gs` for all future commits and branch operations. It prevents further history divergence and restores stack tracking, though you should use `gs` commands exclusively going forward.

Do I need a separate tool to write commit messages when using git-spice?

Yes. This Skill requires the writing-commit-messages Skill to generate proper commit messages before running `gs commit create -m` or `gs branch create -m`. Load that Skill first to craft messages that align with your workflow standards.

What happens when I create a new branch with git-spice?

New branches automatically stack on the current feature branch when applicable, maintaining the branch hierarchy. Git-spice then auto-rebases dependent branches, ensuring your stack remains consistent without manual intervention.