auto-commit

Generate a conventional-commit plan for pending git changes in COMMITS.md.

Updated May 2, 2026
One-click install
npx skills add https://github.com/ajbarea/techne --skill auto-commit-ajbarea
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auto-commit
Source: https://github.com/ajbarea/techne/tree/main/plugins/techne/skills/auto-commit
Command: npx skills add https://github.com/ajbarea/techne --skill auto-commit-ajbarea

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of turning a messy working tree into a clean, reviewable set of conventional commits without guessing how to group related changes or losing track of what should land together.

Core Features & Use Cases

  • Plan-only commit structuring: Analyzes unstaged and staged diffs and writes a structured commit plan into COMMITS.md for review before anything is committed.
  • Conventional-commit grouping: Groups files into coherent changes with appropriate types (feat, fix, docs, test, refactor, style, perf, chore, ci, build) and realistic scopes based on actual file paths and repo history.
  • Safe, state-aware regeneration: Detects whether an existing COMMITS.md plan is current by comparing HEAD and a tree fingerprint, preserving a user’s ## Notes when regenerating.
  • Optional execution chain: When explicitly approved, it can create a branch, commit each planned group with the plan’s exact headlines/bullets, push, and open a PR—while avoiding attribution trailers.

Quick Start

Run the skill to generate a plan in COMMITS.md, then say go when you want it to execute the branch → commits → push → PR workflow.

Frequently Asked Questions about auto-commit

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

FAQPage Schema
How do I group pending git changes into conventional commits before pushing?

To group pending git changes into conventional commits, this skill analyzes your working tree diffs and writes a structured commit plan into COMMITS.md, allowing you to review coherent commit batches before anything is executed.

Can I automatically create a branch and pull request from a dirty git working tree?

Yes, you can automatically create a branch and pull request from a dirty working tree by approving the generated commit plan with an explicit go command, which triggers the branch, commit, push, and PR workflow.

How does conventional commit planning work with staged and unstaged files?

Conventional commit planning works by analyzing both staged and unstaged file diffs, grouping related changes by appropriate types like feat or fix, and assigning realistic scopes based on file paths and recent repo history.

What is the best way to review commit batches before shipping code?

The best way to review commit batches before shipping is generating a plan-only COMMITS.md file that structures your pending changes into reviewable conventional commits without immediately modifying your repository state.

Does regenerating a commit plan lose my custom notes in COMMITS.md?

No, regenerating a commit plan does not lose your custom notes. The skill performs state-aware regeneration by comparing HEAD and a tree fingerprint, specifically preserving your ## Notes section when updating the plan.

Why does the commit plan exclude the COMMITS.md file from git diffs?

The commit plan excludes the COMMITS.md file from git diffs to prevent circular commits, ensuring the generated plan file itself is never included as a tracked change in its own proposed commit batches.