taw-commit

Automate standardized git commits with Conventional Commits format and diff-derived type, scope, and subject.

32|13|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/nghiahsgs/taw-kit --skill taw-commit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: taw-commit
Source: https://github.com/nghiahsgs/taw-kit/tree/main/skills/taw-commit
Command: npx skills add https://github.com/nghiahsgs/taw-kit --skill taw-commit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates and standardizes commits for taw-kit projects by enforcing conventional commit structure, deriving type/scope/subject from diffs, and emitting a taw-branded commit message. This reduces human error, accelerates release notes, and ensures consistent history across builds.

Core Features & Use Cases

  • Context-aware commit mode using .taw/checkpoint.json to attach phase tags and follow the CONTEXT mode.
  • SMART mode for ad-hoc diffs with type/scope/subject derivation.
  • Enforces the Conventional Commits format with optional [P<n>] trailers.
  • Scrubs sensitive data before commit to prevent leakage.
  • Produces a readable body and trailers for auditing and release notes.

Quick Start

Run taw-commit after making changes to generate and apply a compliant commit message.

Frequently Asked Questions about taw-commit

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

FAQPage Schema
How do I automate git commit messages from a diff?

To automate git commit messages from a diff, use a diff-aware commit helper that analyzes your changes to derive the type, scope, and subject automatically. This enforces conventional commit formats and reduces human error when standardizing project history.

What is the conventional commits format for automated releases?

The conventional commits format for automated releases structures commit messages with a specific type, scope, and subject, often including optional phase trailers like [P<n>]. This standardization accelerates release notes and ensures consistent history across builds.

How do I scrub secrets before committing code changes?

To scrub secrets before committing code changes, use an automated commit helper that checks and removes sensitive data from diffs prior to finalizing the commit. This prevents accidental leakage of credentials in your version control history.

Can I generate ad-hoc commit messages without orchestrator context?

Yes, you can generate ad-hoc commit messages without orchestrator context by operating in SMART mode. This mode derives the type, scope, and subject directly from your current diffs, allowing you to create compliant conventional commits independently.

How do I attach phase tags to commit messages using checkpoint context?

To attach phase tags to commit messages, use a context-aware commit mode that reads phase information from a checkpoint JSON file. This automatically includes optional [P<n>] phase trailers in your conventional commit messages based on the orchestrator's current state.