source-control-hygiene

Enforce atomic commits with conventional messages across git and jujutsu workflows.

8|Updated Dec 16, 2008
One-click install
npx skills add https://github.com/sebnow/configs --skill source-control-hygiene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: source-control-hygiene
Source: https://github.com/sebnow/configs/tree/main/home-manager/agentic/skills/source-control-hygiene
Command: npx skills add https://github.com/sebnow/configs --skill source-control-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintains a clear, auditable project history by guiding developers through VCS detection, atomic commits, and robust messaging before every commit.

Core Features & Use Cases

  • VCS detection (prefer jujutsu when available) and routing to the appropriate commands for commit, status, and diff.
  • Atomic commits: enforce one logical change per commit with explicit testing or validation where applicable.
  • Pre-commit protocol: review diffs, run tests, validate messages, and ensure adherence to project conventions before committing.

Quick Start

Detect the project’s VCS (prefer jujutsu when available) and enforce atomic commits with explicit, conventional messages before any commit operation.

Frequently Asked Questions about source-control-hygiene

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

FAQPage Schema
How do I enforce atomic commits with conventional messages in git?

To enforce atomic commits in git, you need a pre-commit protocol that reviews diffs, runs tests, and validates conventional messages before any commit operation, ensuring one logical change per commit and maintaining an auditable history.

What is an atomic commit and why is it important for version control?

An atomic commit isolates a single logical change with explicit validation and conventional messaging. It is important for version control because it creates a clear, auditable project history and guards against unsafe or ambiguous commits.

Does this source-control hygiene workflow support jujutsu alongside git?

Yes, this source-control hygiene workflow supports jujutsu alongside git. It features VCS detection that prefers jujutsu when available, routing to the appropriate commands for commit, status, and diff operations across both environments.

How do I set up pre-commit checks to validate commit messages?

To set up pre-commit checks for commit message validation, implement a protocol that intercepts commit creation to review diffs, run tests, and enforce conventional-commit formatting before the commit operation completes.

What is the best way to keep git history clean and auditable?

The best way to keep git history clean and auditable is enforcing atomic changes with explicit, conventional messages during commit creation. Applying pre-commit checks and VCS-detection protocols prevents unsafe or ambiguous history.

When should I not use automated commit validation protocols?

You should avoid automated commit validation protocols during rapid prototyping where unstructured saves are prioritized over strict history audits, as these protocols intentionally enforce diff reviews and conventional message formatting before every commit.