commit-message

Generates conventional commit messages from git diffs and plan files without committing.

Updated Jan 4, 2026
One-click install
npx skills add https://github.com/threadedstack/threadedstack --skill commit-message-threadedstack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: commit-message
Source: https://github.com/threadedstack/threadedstack/tree/main/.claude/skills/commit-message
Command: npx skills add https://github.com/threadedstack/threadedstack --skill commit-message-threadedstack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing consistent, well-formatted commit messages is tedious and often skipped, leading to unclear git history. This Skill analyzes your working tree changes and produces a properly formatted conventional commit message, without ever touching git state. ## Core Features & Use Cases - Read-Only Git Analysis: Inspects staged and unstaged changes via git status and git diff, with strict safety rules that prohibit any commit, push, or history modification. - Plan-Aware Context: Detects plan files among changed files and uses them as the primary basis for the message, cross-referencing intent against actual code changes. - Conventional Commits Formatting: Applies correct type, scope, imperative description, body, and breaking-change footers, including dependency bump formatting. - Use Case: After finishing a feature across backend and domain packages, ask for a commit message and receive something like feat(backend,domain): add quota model and API with a body summarizing the plan deliverables. ## Quick Start Review my current uncommitted changes and write a conventional commit message for them.

Frequently Asked Questions about commit-message

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

FAQPage Schema
How do I generate a conventional commit message from my changes?▼

Run the skill against your working tree and it inspects git status, unstaged diffs, and staged diffs to determine the change type and scope. It outputs a formatted conventional commit message with an analysis of type, scope, and files changed.

How to write a commit message when a plan file exists?▼

The skill detects files matching plan patterns among changed files and reads them as the primary context. It cross-references the plan's intended scope against actual code changes and summarizes key deliverables in the commit body.

Does this tool commit or modify my git history?▼

No, it is strictly read-only. It never runs git add, commit, push, reset, revert, rebase, or cherry-pick, and only outputs the message as text for you to commit manually.

What commit types and scopes does conventional commits support?▼

Supported types include feat, fix, refactor, test, docs, style, perf, chore, ci, build, and revert. Scope is derived from the primary area of change, such as backend or domain, and is omitted for cross-cutting changes.

What happens when changes span multiple unrelated concerns?▼

The skill suggests splitting the work into multiple commits, presenting each logical grouping separately with its own conventional commit message and file grouping.