git-guidelines

Enforces staged Git workflows with per-file checkpoints and descriptive commit messages.

1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/dzackgarza/ai --skill git-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-guidelines
Source: https://github.com/dzackgarza/ai/tree/main/opencode/skills/git-guidelines
Command: npx skills add https://github.com/dzackgarza/ai --skill git-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Regular Git workflows are error-prone when editing multiple files, making it hard to trace why changes were made and risking messy histories. This Skill enforces a safety net by guiding Read → Checkpoint → Edit → Verify steps, requiring per-file checkpoints and descriptive commit messages to improve traceability and rollback capability.

Core Features & Use Cases

  • Per-file checkpoints: checkpoint before editing each file to capture the current state and allow precise rollbacks.
  • Mandatory, descriptive commits: commit messages must explain the rationale, scope, and outcomes of changes.
  • Structured workflow: define and follow a Read → Checkpoint → Edit → Verify sequence for every edit, with explicit verification after each change.
  • Safe operations guidance: rules for branching, pushing, and deleting files to prevent destructive actions and ensure review-friendly histories.

Quick Start

Begin by checkpointing before editing each file and writing a descriptive commit message that documents the rationale for every change.

Frequently Asked Questions about git-guidelines

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

FAQPage Schema
How do I enforce safe Git workflows when editing multiple files?

Safe Git workflows are enforced by mandating per-file checkpoints and descriptive commit messages. This requires applying a Read, Checkpoint, Edit, and Verify sequence for every edit to capture the current state and allow precise rollbacks.

What's the best way to prevent destructive actions in version control?

Preventing destructive actions in version control involves enforcing safe-branching rules, explicit verification after each change, and structured commit guidelines. These rules ensure review-friendly histories and prevent accidental data loss.

Why do I need per-file checkpoints in my Git workflow?

Per-file checkpoints are needed in Git workflows to capture the current state before editing each file. This practice allows precise rollbacks and makes it easier to trace exactly why specific changes were made, improving overall traceability.

How do I write descriptive commit messages for traceability?

Descriptive commit messages for traceability must document the rationale, scope, and outcomes of changes. This structured approach replaces vague messages, ensuring the history clearly explains the reasoning behind every modification.

Can I use a structured Read, Checkpoint, Edit, Verify sequence for code review?

The Read, Checkpoint, Edit, Verify sequence supports code review by requiring explicit checks after each modification. Following this structured workflow ensures modifications are auditable and generates review-friendly commit histories.

What are the limitations of using structured Git checkpoints?

Structured Git checkpoints require strict adherence to the Read, Checkpoint, Edit, Verify workflow for every file edit. This overhead may slow down rapid prototyping but is necessary to maintain auditable histories and rollback capability.