commit-helper

Create and execute git commit plans from YAML files.

Updated Dec 1, 2025
One-click install
npx skills add https://github.com/mandersogit/brynhild-harness --skill commit-helper-mandersogit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-helper
Source: https://github.com/mandersogit/brynhild-harness/tree/main/src/brynhild/builtin_skills/commit-helper
Command: npx skills add https://github.com/mandersogit/brynhild-harness --skill commit-helper-mandersogit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires click, pyyaml, and includes scripts (resource) components.

What problem does it solve?

Create and execute git commit plans from YAML files to organize changes into logical commits and improve Git hygiene, with explicit user authorization required for any actual commits.

Core Features & Use Cases

  • Generate commit plans in YAML
  • Preview plans before execution
  • Execute commits only with user authorization
  • Handle multi-file, multi-commit workflows with idempotence

Quick Start

Use the included script in this Skill to plan or execute commits:

  • Preview: python scripts/commit-helper.py plan.yaml
  • Execute: python scripts/commit-helper.py plan.yaml --execute

Frequently Asked Questions about commit-helper

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

FAQPage Schema
How do I organize multiple git commits from staged changes using a plan file?

Create a YAML file defining your commit sequence with file groupings and messages, then run the commit-helper script to preview and execute commits. This organizes changes into logical commits while preventing duplicate files across multiple commits.

Can I preview my commit plan before executing it?

Yes. Run the script with your YAML plan file without the --execute flag to preview all planned commits, file assignments, and commit messages before any changes are written to git history.

What validation does commit-helper perform on YAML commit plans?

The tool validates that all files exist in your repository, prevents the same file from appearing in multiple commits, and requires explicit user authorization before executing any commits to ensure safety.

How do I use commit-helper with a repository outside my current directory?

Pass an optional repo path override in your YAML configuration to point the tool to a different repository location, allowing you to plan and execute commits across multiple projects.

Can I rerun a commit plan after making changes?

Yes. Commit plans are idempotent, so you can rerun the same YAML plan multiple times as you update your staged changes, and the tool will execute only the commits you authorize each time.

Do I need git installed to use commit-helper?

Yes. Commit-helper automates git operations through YAML plans, so you need git installed and configured on your system for the tool to create and execute commits.