One-click install
npx skills add https://github.com/KunYi/Skills --skill git-commit-intelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-commit-intelligence
Source: https://github.com/KunYi/Skills/tree/main/git-commit-intelligence
Command: npx skills add https://github.com/KunYi/Skills --skill git-commit-intelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents vague, misleading, or inconsistently scoped git commit messages by enforcing a strict structure and requiring clear reasoning for each change.

Core Features & Use Cases

  • Conventional Commits output: Produces type(scope): summary titles plus a why paragraph and bullet-point change list.
  • Semantic domain + scope inference: Determines whether the change is embedded, driver, desktop, or other, and assigns a scope based on responsibility rather than filenames.
  • Confidence gating with ASK mode: Avoids finalizing commits when domain, scope, or type is ambiguous, prompting up to two targeted multiple-choice questions instead.
  • Scoring and auto-rewrite: Scores results (0–100) and automatically revises if the score is below 75 (up to two rewrite attempts), improving format fidelity and clarity.

Quick Start

Use git-commit-intelligence to generate a structured Conventional Commits message for the changes you are about to commit, and ask follow-up questions only if type or scope is unclear.

Frequently Asked Questions about git-commit-intelligence

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

FAQPage Schema
How do I generate conventional commit messages for unfamiliar repositories?

To generate conventional commit messages for unfamiliar repositories, use a tool that applies semantic type and scope inference to your staged changes. It determines the change domain and assigns a scope based on responsibility rather than filenames, producing a structured type(scope): summary format.

What is scope inference in conventional commits and when do I need it?

Scope inference in conventional commits determines the affected code domain, such as embedded, driver, or desktop, and assigns a logical scope label based on responsibility. You need it when working across mixed or unfamiliar repositories where filename-based scoping is misleading or inconsistent.

How do I write a structured git commit message with a clear rationale?

You write a structured git commit message by enforcing a strict format that includes a type and scope in the title, a paragraph explaining why the change was made, and a bullet-point list of what changed. This ensures clear reasoning and review readiness.

Can I automate git commit message generation for mixed code changes?

Yes, you can automate git commit message generation for mixed code changes by using a tool with confidence gating and auto-rewrite capabilities. It scores the generated message on format fidelity and clarity, automatically revising the output if the score falls below a set threshold.

What happens if the commit type or scope is ambiguous during message generation?

If the commit type or scope is ambiguous during message generation, confidence gating prevents finalizing the message. Instead, the system prompts you with up to two targeted multiple-choice questions to resolve the ambiguity before proceeding.

Does automated commit message generation work for embedded and driver code changes?

Yes, automated commit message generation works for embedded and driver code changes by applying semantic domain inference. It identifies the specific technical domain of your modifications and structures the commit message accordingly to ensure review readiness.